Passer à la navigation

Transactions et tentatives

Afficher en Markdown

Un retrait est une opération commerciale asynchrone. Une réponse HTTP réussie signifie que la demande a été traitée ; cela n’établit pas que les fonds sont arrivés en chaîne.

Conserver un identifiant d’entreprise

Générez et stockez client_request_id avant d’envoyer un retrait. Réutilisez-le pour les nouvelles tentatives de la même opération prévue, y compris après le redémarrage d’un processus. Gardez les champs de la transaction cohérents ; la mise en œuvre actuelle rejette un identifiant répété avec des paramètres commerciaux contradictoires.

Ne vous fiez pas uniquement à un en-tête Idempotency-Key. Le SDK fourni peut ajouter cet en-tête, mais le contrat de déduplication de retrait actuel est basé sur le champ du corps client_request_id.

Comprendre les données de la demande

ChampSignification
chain_id, asset_idIdentifiants dans l’environnement convenu
to_address, amountDestination et un montant décimal positif représenté sous forme de chaîne
client_request_idIdentifiant de demande commerciale stable
dest_memo_type, dest_memoDétails du mémo de destination là où le réseau les requiert
client_authorizationAutorisation de transaction client pour les retraits initiés par la clé API
end_user_idIdentifiant d’utilisateur professionnel facultatif dans le flux d’entreprise API

Ce tableau met en évidence les champs principaux, et non un schéma de demande complet. Confirmez l’aperçu, la confirmation des frais et les exigences spécifiques à la garde par rapport à la version d’intégration. Évitez les montants binaires à virgule flottante et ne copiez pas d’exemples de chaîne ou de numéros d’actifs entre environnements.

Suivez le résultat

Exemples d’étatInterprétation
pending_approval, pending_platform_reviewUne approbation ou un examen commercial est en attente
approved, pending_signL’approbation et la signature sont des étapes distinctes
broadcasting, pending_chainLa diffusion ou la confirmation de la chaîne est en cours
broadcast_unverified, recoveringL’issue est encore incertaine ; ne pas créer un autre transfert
awaiting_reauthorizationUne nouvelle autorisation client peut être requise pour la même demande
confirmedLe système a enregistré la confirmation de la chaîne

La liste est indicative et peut évoluer. Préservez les états inconnus pour l’investigation au lieu de les mapper sur le succès ou l’échec. Un label raté ou rejeté ne constitue pas à lui seul une preuve suffisante que rien n’a été signé ou diffusé.

Récupérer après un délai d’attente

Interrogez GET /api/v1/withdrawals/by-request à l’aide du paramètre de requête client_request_id d’origine. Continuez à interroger ou à rapprocher l’opération d’origine tant que son résultat est incertain. Si un renouvellement de l’autorisation est requis, utilisez le même identifiant et la procédure de renouvellement convenue.

L’annulation dépend de l’étape de signature réelle et des contrôles du serveur. Ne démarrez une opération commerciale de remplacement qu’une fois que l’original est établi comme non transféré et incapable de être transféré. Recevez des événements via webhookset conservez les requêtes API comme chemin de réconciliation.