Transactions et tentatives
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
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
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.