Événements - Mercy Pay

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`

{
  "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 et Payouts.