API
Auf dieser Seite
Abrufen
Rufen Sie eine Rechnungserstattung über ihre Auszahlungs-ID ab, prüfen Sie Status sowie On-Chain-Hash und gleichen Sie den Abschluss ab.
GET/v1/refunds/:withdrawal_id
API-Schlüssel: Payment
Gibt den aktuellen Status einer Rechnungserstattung anhand ihrer withdrawal_id (wdr_...) zurück. Sobald die Auszahlung completed erreicht, enthält die Antwort den bestätigten tx_hash und die explorer_url.
Antwort (200 OK)
{
"withdrawal_id": "wdr_6Qm2fK8xR4vN7cT1bY9dL5",
"invoice_id": "inv_7K2M9P4Q8R1X5Z3A0bC2dE",
"mode": "full",
"external_order_id": "refund-1042-full",
"status": "completed",
"is_final": true,
"is_test": false,
"amount": "100.00",
"fee": "1.00",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"first_sender": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"tx_hash": "9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
"explorer_url": "https://tronscan.org/#/transaction/9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
"created_at": 1767225600,
"completed_at": 1767225932,
"type": "refund",
"project_id": "prj_3F9xL2mN8pQ4rT6vW1yZ5b"
}
Erstattungsstatus
| Status | Beschreibung | Terminal |
|---|---|---|
created |
Erstattung erstellt und Guthaben reserviert, wartet auf Signierung | Nein |
signed |
Transaktion signiert und an die Blockchain gesendet | Nein |
pending_review |
Gesendete Transaktion wurde innerhalb der TTL nicht bestätigt; wartet auf Klärung | Nein |
cancelling |
Stornierung auf der Chain eingeleitet; wartet auf Bestätigung, welche Transaktion aufgenommen wird | Nein |
completed |
Erstattung On-Chain bestätigt und an first_sender zugestellt (is_final: true) |
Ja |
failed |
Erstattung vor Abwicklung fehlgeschlagen oder abgebrochen; reservierte Mittel wurden dem Händlerguthaben wieder gutgeschrieben | Ja |
cancelled |
Erstattung vor dem Senden storniert; reservierte Mittel wurden dem Händlerguthaben wieder gutgeschrieben | Ja |
Fehler
Ein Payout-Schlüssel (rk_) wird mit 403 payment_key_required abgewiesen. Wenn withdrawal_id nicht existiert, zu einer regulären Auszahlung statt zu einer Erstattung gehört oder außerhalb des Projektbereichs Ihres Schlüssels liegt, gibt der Endpunkt 404 withdrawal_not_found zurück. Siehe Fehlercodes.