Ajouter un point de terminaison
Tableau de bord → Webhooks → ajoutez votre URL HTTPS et choisissez les événements (commencez parpayment.confirmed). Vous obtiendrez un secret
de signature (whsec_…).
Payload
Vérifier la signature
Vérifiez toujours avant de faire confiance à quoi que ce soit :Événements
Les payloads
wallet.* et bridge.* incluent walletId/bridgeTransferId,
chain/route, amount, et les hachages de transaction pertinents —
avec la même forme que leurs réponses API dans Wallets et
Bridge.
Litiges
Un litige s’ouvre lorsqu’un client, depuis votre page de checkout, signale avoir envoyé des fonds qui ne se sont pas confirmés automatiquement — mauvais montant, mauvaise adresse, ou envoi tardif. C’est en libre-service côté client (il reçoit instantanément un résultatmatchedWallet /
amountCovered / lateByMinutes), et payment.dispute_opened vous donne
le même niveau de détail pour un suivi manuel si la vérification
automatique ne résout pas le problème — par exemple, créditer une
commande malgré un paiement légèrement incomplet, à votre discrétion.
Livraison et nouvelles tentatives
- Répondez
2xxen moins de 10 secondes ; toute autre réponse compte comme un échec. - Nous réessayons jusqu’à 3 fois avec un backoff ; les livraisons et codes de statut sont visibles dans le tableau de bord.
- Les gestionnaires doivent être idempotents — utilisez
paymentIntentIdcomme clé.