É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 Logs 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, retour à PENDING.
transfer.succeeded	Transfert d’argent sortant arrivé sur le compte du bénéficiaire (data = le transfert, voir Envoyer de l’argent).
transfer.failed	Transfert d’argent refusé par l’opérateur ou le fournisseur, avec data.failure.

Corps de la requête

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

{
  "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": "awa@example.com",
    "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 Cartflox (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)