Événements

Chaque requête contient un événement, les données du paiement, un horodatage et livemode. Vous choisissez les événements reçus dans API et journaux ou par l’API.

Événement	Quand
payment.completed	Paiement confirmé (statut SUCCESS). C’est l’événement à attendre pour livrer.
payment.failed	Paiement échoué ou refusé (statut FAILED).
payment.cancelled	Paiement abandonné par le client (page quittée, session expirée) ou annulé par le marchand (statut CANCELLED). Événement ajouté le 19 septembre 2026 : les webhooks configurés avant cette date ne le reçoivent qu’après l’avoir coché dans API et Logs.
payment.updated	Tout autre changement de statut : REFUNDED (remboursement fait par l’équipe nyole), retour à PENDING.

Corps de la requête

POST https://maboutique.com/webhooks/nyole

{
  "event": "payment.completed",
  "livemode": true,
  "data": {
    "id": "cmf3k2p1x0001abcd9e8f7g6h",
    "order_id": "CS-MF3K2A-9X1QZ",
    "status": "SUCCESS",
    "amount": 5000,
    "currency": "XOF",
    "provider": "PayDunya",
    "provider_reference": "pd_7f3a9c",
    "customer_name": "Awa Koné",
    "customer_email": "[email protected]",
    "customer_phone": "+2250700000000",
    "metadata": { "order_id": "1042", "source": "checkout_session" },
    "completed_at": "2026-09-02T10:17:42.000Z"
  },
  "timestamp": "2026-09-02T10:17:42.000Z"
}

Champ	Description
data.id	Identifiant de la session, le même que celui renvoyé à la création
data.order_id	Référence nyole (CS-...)
data.status	SUCCESS, FAILED, PENDING, CANCELLED ou REFUNDED
data.provider	Passerelle qui a traité le paiement
data.provider_reference	Référence chez l’agrégateur, utile pour vos rapprochements
data.metadata	Vos métadonnées, enrichies de la source (checkout_session, payment_link…)
data.completed_at	Date de confirmation, null tant que le paiement n’est pas réussi
livemode	true en production, false pour un paiement fait avec une clé de test (mode test)