Transaktionen und Wiederholungsversuche
Eine Auszahlung ist ein asynchroner Geschäftsvorgang. Eine erfolgreiche HTTP-Antwort bedeutet, dass die Anfrage bearbeitet wurde; Es wird nicht nachgewiesen, dass die Gelder in der Kette angekommen sind.
Behalten Sie eine Geschäftskennung bei
Generieren und speichern Sie client_request_id, bevor Sie eine Auszahlung senden. Verwenden Sie es für Wiederholungsversuche desselben beabsichtigten Vorgangs, auch nach einem Prozessneustart. Halten Sie die Felder der Transaktion konsistent. Die aktuelle Implementierung lehnt einen wiederholten Bezeichner mit widersprüchlichen Geschäftsparametern ab.
Verlassen Sie sich nicht nur auf einen Idempotency-Key-Header. Der bereitgestellte SDK kann diesen Header hinzufügen, aber der aktuelle Auszahlungs-Deduplizierungsvertrag basiert auf dem Textfeld client_request_id.
Anforderungsdaten verstehen
In dieser Tabelle werden Kernfelder hervorgehoben, kein vollständiges Anforderungsschema. Überprüfen Sie Vorschau, Gebührenbestätigung und verwahrungsspezifische Anforderungen anhand der Integrationsversion. Vermeiden Sie binäre Gleitkommabeträge und kopieren Sie keine Beispielketten- oder Asset-Nummern zwischen Umgebungen.
Verfolgen Sie das Ergebnis
Die Liste dient der Veranschaulichung und kann sich weiterentwickeln. Bewahren Sie unbekannte Zustände zur Untersuchung auf, anstatt sie auf Erfolg oder Misserfolg zurückzuführen. Ein fehlgeschlagenes oder abgelehntes Etikett allein ist kein ausreichender Beweis dafür, dass nichts unterzeichnet oder ausgestrahlt wurde.
Wiederherstellung nach einer Zeitüberschreitung
Fragen Sie GET /api/v1/withdrawals/by-request mit dem ursprünglichen Abfrageparameter client_request_id ab. Führen Sie weiterhin eine Abfrage oder einen Abgleich des ursprünglichen Vorgangs durch, solange das Ergebnis ungewiss ist. Wenn eine Erneuerung der Autorisierung erforderlich ist, verwenden Sie dieselbe Kennung und das vereinbarte Erneuerungsverfahren.
Die Stornierung hängt von der tatsächlichen Signierphase und den Prüfungen des Servers ab. Starten Sie einen Ersatzgeschäftsbetrieb erst, wenn festgestellt wurde, dass der ursprüngliche Geschäftsbetrieb nicht übertragen wurde und nicht übertragen werden kann. Erhalten Sie Ereignisse über webhooksund behalten Sie API-Abfragen als Abgleichspfad bei.