Abrufen

API-Schlüssel: Payout

Gibt den aktuellen Zustand einer Auszahlung zurück. Der bestätigte tx_hash und die explorer_url erscheinen, sobald die Auszahlung completed erreicht.

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	Auszahlung angelegt, wartet auf die Signatur	Nein
signed	Transaktion signiert und an die Blockchain gesendet	Nein
cancelling	Ein Administrator hat im Zustand pending_review eine Stornierung ausgelöst; es wird abgewartet, welche Transaktion on-chain bestätigt wird	Nein
completed	Transaktion on-chain bestätigt, Auszahlung ausgeliefert. Auf der Leitung endgültig (is_final: true), auch wenn eine tiefe Reorganisation sie zurück auf signed setzen kann — siehe die Übergänge unten	Ja
failed	Die Signatur schlug vor dem Senden fehl, ein Operator hat eine hängengebliebene Auszahlung aufgegeben, oder eine Stornierung wurde on-chain bestätigt. Die Mittel gehen zurück ins Guthaben	Ja
cancelled	Der Händler hat storniert, solange der Status noch created war	Ja
pending_review	Die Transaktion wurde signiert, war aber nach Ablauf der TTL nicht on-chain zu finden. Erfordert manuelle Klärung	Nein

Zustandsübergänge

• created -> signed -- Transaktion signiert und gesendet
• created -> cancelled -- der Händler storniert (der einzige gültige Übergang beim Stornieren)
• created -> failed -- die Signatur schlug fehl
• created -> completed -- der Händler simuliert den Abschluss über POST /v1/sandbox/withdrawals/{id}/simulate-completion (nur Sandbox — keine Signatur, keine Chain)
• signed -> completed -- Transaktion on-chain bestätigt
• signed -> pending_review -- die signierte Transaktion war nach Ablauf der TTL nicht on-chain zu finden (oder wurde zurückgesetzt); eine zurückgesetzte Transaktion bleibt signed, bis die TTL sie eskaliert
• pending_review -> cancelling -- ein Administrator löst die Stornierung aus
• pending_review -> completed -- die ursprüngliche Transaktion wird on-chain gefunden und bestätigt (durch den Scanner, nicht durch eine Administratoraktion)
• pending_review -> failed -- ein Administrator gibt die hängengebliebene Auszahlung auf
• cancelling -> completed -- die ursprüngliche Transaktion wurde zuerst bestätigt, die Auszahlung ging also durch
• cancelling -> failed -- stattdessen wurde die Stornierungstransaktion on-chain bestätigt; die Mittel gehen zurück ins Guthaben
• completed -> signed -- selten: Eine Reorganisation der Chain hat die bestätigte Auszahlungstransaktion verdrängt, die Auszahlung fällt auf signed zurück und schließt erneut ab, sobald diese Transaktion oder ihr Ersatz in einen Block aufgenommen wird

Fehler

Den vollständigen Katalog finden Sie unter Fehlercodes. Die type-URI in jeder Fehlerantwort verweist direkt auf die passende Zeile.