Skip to main content

Ajouter un point de terminaison

Tableau de bord → Webhooks → ajoutez votre URL HTTPS et choisissez les événements (commencez par payment.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ésultat matchedWallet / 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 2xx en 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 paymentIntentId comme clé.