Zum Inhalt springen

API

Auf dieser Seite

Entsperren

Einem Zahlungskanal wieder Einzahlungen zuordnen; der Server setzt ihn auf active oder provisioning, je nachdem, ob schon eine Adresse existiert.

POST/v1/payment-channels/:payment_channel_id/unblock

API-Schlüssel: Payment

Macht ein Sperren rückgängig. Der Kanal nimmt auf jedem Weg, den er hat, wieder Einzahlungen an.

Kein Anfragekörper.

Welchen Status Sie zurückbekommen

Sie wählen ihn nicht — der Server leitet ihn daraus ab, was der Kanal tatsächlich hat:

Bedingung Status danach
Mindestens ein Netzwerk hat bereits eine Adresse active
Es existiert noch keine Adresse provisioning

Weil die Bereitstellung auch während einer Sperre weiterläuft, kommt ein früh gesperrter und später entsperrter Kanal meist als active zurück, mit mehr fertigen Netzwerken als zuvor.

Ein erneuter Aufruf auf einem Kanal, der nicht gesperrt ist, bewirkt nichts und gibt denselben Kanal mit 200 OK zurück.

Antwort (200 OK)

Das vollständige Kanalobjekt, in derselben Form, die Abrufen liefert, mit dem oben hergeleiteten status.

Fehler

Code HTTP Wann
payment_channels_disabled 503 Zahlungskanäle sind für Ihr Konto in dieser Umgebung nicht freigeschaltet.
payment_key_required 403 Die Anfrage wurde mit einem Payout-Schlüssel (rk_) signiert.
payment_channel_not_found 404 Die Kennung führt zu nichts, was diese Zugangsdaten sehen dürfen.
field_invalid_format 400 Das Pfadsegment ist keine gültige pc_-Kennung.

Den vollständigen Katalog finden Sie unter Fehlercodes.

Zahlungskanal sperren Einzahlungen der Kanäle abfragen