> ## 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.

# Événements

> Les quatre événements envoyés aux marchands, avec leur contenu.

Mercy Pay envoie quatre types d'événements, et c'est à vous de choisir lesquels chaque endpoint reçoit, pas besoin de tout gérer si vous ne vous intéressez qu'aux paiements, par exemple.

| Événement | Déclencheur |
| - | - |
| `payment.succeeded` | Un paiement est encaissé. Le solde est crédité. |
| `payment.failed` | Un paiement est refusé, annulé ou expiré. |
| `payout.paid` | Un payout est versé sur le compte du bénéficiaire. |
| `payout.failed` | Un payout échoue ou est refusé. Le motif est dans `failure_reason`. |

## Enveloppe

Chaque événement suit la même structure :

| Champ | Description |
| - | - |
| `id` | Identifiant unique, de la forme `evt_…`. Sert à dédupliquer. |
| `type` | Nom de l'événement, par exemple `payout.paid`. |
| `data` | Ressource concernée. |

## Exemple `payout.paid`

```json theme={null}
{
  "id": "evt_01J9Z6P0E3VW8KZ2RMQ4YTB7XN",
  "type": "payout.paid",
  "data": {
    "uuid": "a9d4e6f2-1b3c-4e5d-8f70-2c9b6a1e3d48",
    "amount": 4000,
    "fee_amount": 80,
    "net_amount": 3920,
    "currency": "XAF",
    "destination": {
      "type": "mobile_money",
      "country": "CMR",
      "provider": "MTN_MOMO_CMR",
      "phone": "237680000000"
    },
    "status": "paid",
    "psp_reference": "b71e0c4d-5f2a-4c8e-9d13-6a0f7b2e4c95",
    "failure_reason": null,
    "created_at": "2026-10-03T10:12:00+00:00"
  }
}
```

Les champs de `data` sont décrits dans [Paiements](/api/payments) et [Payouts](/api/payouts).


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