> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Mercy Pay notifie votre serveur à chaque changement de statut d'un paiement ou d'un payout.

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 :

1. Saisissez une URL HTTPS publique qui accepte les requêtes `POST`.
2. Cochez les événements à recevoir.
3. 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

```http theme={null}
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](/webhooks/events).

## 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](/guides/handle-webhooks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.