Aller plus loin

Statuts & erreurs

Un paiement mobile money passe par plusieurs mains avant d'aboutir. Cette page dit ce que chaque état signifie, comment savoir où en est une transaction, et quoi faire quand ça se passe mal.

Les quatre statuts

Vérifier où en est une transaction

Le webhook reste la source de vérité, mais vous pouvez demander l'état à tout moment — c'est recommandé quand un client revient sur votre page de remerciement.

{
  "success":  true,
  "token":    "9d3f7a21c4",
  "status":   "completed",
  "amount":   5000,
  "currency": "XOF",
  "env":      "live",
  "customer": { "name": "Awa Diop", "email": null, "phone": "90123456" }
}

<?php
// Un client revient sur votre page « merci » : ne vous fiez pas à l'URL, demandez.
$d = appelTchin('GET', '/payments/'.$token.'/status');

switch ($d['status'] ?? 'pending') {
    case 'completed':
        // Le webhook a peut-être déjà fait le travail : restez idempotent.
        livrerUneSeuleFois($token);
        return vue('merci');

    case 'pending':
        return vue('paiement-en-cours');   // proposez d'actualiser dans 10 s

    case 'failed':
    case 'cancelled':
        return vue('paiement-echoue');     // proposez de réessayer
}

Ce que nous vérifions pour vous

Les webhooks se perdent : votre serveur redémarre, le réseau coupe, un pare-feu bloque. Deux services tournent en permanence pour que rien ne reste en suspens.

Un panier jamais payé — page ouverte, rien validé — est clôturé au bout de deux heures et passe en cancelled. Vous n'avez donc jamais de transaction éternellement en attente.

Les codes HTTP

Forme des erreurs

{
  "success": false,
  "message": "Opérateur « mtn-ci » indisponible pour le pays TG."
}

{
  "message": "The amount field is required.",
  "errors": {
    "amount": ["The amount field is required."]
  }
}

Un 200 ne veut pas dire « ça a marché » : regardez toujours success. Le champ message est rédigé pour être montré à un humain — le vôtre, pas forcément votre client final.

Les erreurs qu'on voit le plus