Zur Navigation springen

Transaktionen und Wiederholungsversuche

Als Markdown anzeigen

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

FeldBedeutung
chain_id, asset_idBezeichner in der vereinbarten Umgebung
to_address, amountZiel und ein positiver Dezimalbetrag, dargestellt als Zeichenfolge
client_request_idStabile Kennung der Geschäftsanfrage
dest_memo_type, dest_memoZielmemodetails, sofern das Netzwerk sie benötigt
client_authorizationAutorisierung von Kundentransaktionen für mit dem API-Schlüssel initiierte Abhebungen
end_user_idOptionaler Geschäftsbenutzerbezeichner im Unternehmensablauf API.

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

Staatliche BeispieleInterpretation
pending_approval, pending_platform_reviewEine geschäftliche Genehmigung oder Bewertung steht noch aus
approved, pending_signGenehmigung und Unterzeichnung sind separate Schritte
broadcasting, pending_chainDie Übertragung oder Kettenbestätigung wird ausgeführt
broadcast_unverified, recoveringDer Ausgang ist noch ungewiss; Erstellen Sie keine weitere Übertragung
awaiting_reauthorizationFür dieselbe Anfrage ist möglicherweise eine erneute Kundenautorisierung erforderlich
confirmedDas System hat die Kettenbestätigung erfasst

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.