Abrufen

API-Schlüssel: Payout

Gibt den aktuellen Zustand einer Auszahlung zurück. tx_hash und explorer_url werden gefüllt, sobald eine verfolgte On-Chain-Transaktion vorliegt — das ist vor completed der Fall. Ob die Auszahlung durch ist, sagen status und is_final, nicht das Vorhandensein des Hashes.

Antwort (200 OK)

{
  "withdrawal_id": "wdr_2M8K6Q4P9X1Z7A3B",
  "external_order_id": "payout-001",
  "status": "completed",
  "is_final": true,
  "is_test": false,
  "amount": "100.00",
  "fee": "1.00",
  "currency": "USDT",
  "network": "TRC20",
  "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "tx_hash": "9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "explorer_url": "https://tronscan.org/#/transaction/9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "created_at": 1739289600,
  "completed_at": 1739289932
}

Auszahlungsstatus

Status	Beschreibung	Endgültig
created	Die Auszahlung ist angelegt und noch nicht im Netzwerk	Nein
signed	Die Transaktion ist signiert und an die Blockchain gesendet	Nein
cancelling	Die Auszahlung wird storniert; wie es ausgeht, sagt der nächste Status	Nein
completed	Die Transaktion ist on-chain bestätigt, das Geld ist zugestellt	Ja
failed	Die Auszahlung ging nicht hinaus. Der Betrag ist zurück im Guthaben	Ja
cancelled	Der Händler hat die Auszahlung storniert, sie ging nicht hinaus. Der Betrag ist zurück im Guthaben	Ja
pending_review	Die Transaktion ist im Netzwerk noch nicht bestätigt, der Betrag bleibt reserviert. Im Dashboard heißt dieser Status „Unbestätigt“	Nein

Wie man das im Code liest

Endgültig sind drei Status: completed, failed und cancelled. Jede Antwort und jeder Webhook führt das Feld is_final — verzweigen Sie darauf, nicht auf eine Namensliste, die Sie selbst pflegen müssten.

Stornieren lässt sich eine Auszahlung nur, solange sie in created steht. Danach wird der Storno abgelehnt, siehe Auszahlung stornieren. Warum eine Auszahlung nicht hinausging, gibt die API nicht zurück: failed hat einen Status, aber kein Feld mit einer Begründung.

Im Sandbox-Betrieb bringt POST /v1/sandbox/withdrawals/{id}/simulate-completion eine Auszahlung von created nach completed — ohne Signatur und ohne Chain.

Fehler

Ein Payment-Schlüssel (pk_) wird mit 403 payout_key_required abgewiesen. Den vollständigen Katalog finden Sie unter Fehlercodes. Die type-URI in jeder Fehlerantwort verweist direkt auf die passende Zeile.