Webhooks - Mercy Pay

Un webhook est une requête POST que Mercy Pay envoie à une URL de votre serveur dès qu’un statut change. Vous n’avez rien à interroger en boucle : l’information vient à vous.

Configurer un endpoint

Depuis Webhooks dans votre tableau de bord :

Saisissez une URL HTTPS publique qui accepte les requêtes POST.
Cochez les événements à recevoir.
Copiez le secret de signature (whsec_…) affiché une seule fois.

Rien ne vous limite à un seul endpoint. Déclarez-en plusieurs si besoin, chacun garde son propre secret et sa propre sélection d’événements.

Format d’une livraison

POST /webhooks/mercy-pay HTTP/1.1
Content-Type: application/json
X-MercyPay-Event: payment.succeeded
X-MercyPay-Signature: 6f1c2e9b0a4d7f83c51e2b9d0a6f47c8e3b15d2a9f0c7e4b8d1a6f3c2e9b0a47

Le corps est un événement : id, type et data. Le contenu de data reprend la ressource correspondante : un paiement pour payment.*, un payout pour payout.*. Voir Événements.

Fiabilité

Mercy Pay attend une réponse 2xx dans les 10 secondes.
Sinon, la livraison est reprise jusqu’à 5 tentatives, espacées d’une minute à deux heures.
Un même événement peut être livré plusieurs fois : dédupliquez-le avec son id.

Pour la mise en œuvre pas à pas, voir Gérer les webhooks.