Le verdict en trois phrases
Le double debit est le pire incident de paiement : il ne coute pas seulement de l'argent a rembourser, il detruit la confiance du client instantanement. La parade unique et fiable : une cle d'idempotence (un meme reference_id) attachee a chaque tentative, qui bloque toute seconde collecte pour la meme intention d'achat. Sur mobile money, environ 1,2 % des paiements subissent un double clic ou un rejeu reseau, et sans idempotence, chacun devient un double debit a rembourser.
D'ou vient le double debit
Le double debit ne vient presque jamais de l'operateur : il vient de votre application qui envoie deux fois la meme demande de collecte. Trois causes dominent. Le double clic : l'utilisateur, voyant l'ecran figer, appuie deux fois sur "Payer". Le rejeu reseau : la premiere requete part, le reseau timeout avant la reponse, et votre code renvoie automatiquement. Le retry mal concu : un mecanisme de reessai qui relance la collecte au lieu de verifier le statut.
| Cause du double debit | Frequence estimee 2026 | Sans idempotence | Avec idempotence |
|---|---|---|---|
| Double clic utilisateur | Environ 1,2 % | 2 debits | 1 debit, 2e ignore |
| Rejeu reseau (timeout) | Environ 0,8 % | 2 debits | 1 debit, 2e ignore |
| Retry qui recollecte | Variable | 2 debits | 1 debit, 2e ignore |
| Webhook rejoue | Environ 2 % | 2 credits | 1 credit, 2e ignore |
Le timeout USSD, typiquement de 60 s sur mobile money, aggrave le probleme : pendant cette minute d'attente, l'utilisateur croit que rien ne s'est passe et relance. La cle d'idempotence est ce qui permet a la seconde requete d'etre reconnue comme un doublon et ecartee.
La sequence anti-doublon avec l'API MoMo
Le principe : generer une cle d'idempotence unique par intention d'achat (pas par clic), et l'envoyer comme reference_id (ou externalId) a l'operateur. Si une seconde requete arrive avec la meme cle, l'API renvoie le resultat de la premiere sans creer de nouveau debit. Avec l'API MTN MoMo Collection, la sequence s'appuie sur requestToPay puis une verification de statut avant toute capture.
| Etat de transaction | Signification | Action correcte |
|---|---|---|
| PENDING | Collecte demandee, en attente | Attendre, ne pas recollecter |
| SUCCESSFUL | Debit confirme | Marquer paye, livrer |
| FAILED | Debit refuse | Reafficher le panier |
| TIMEOUT | Aucune reponse USSD | Verifier le statut, pas recollecter |
| Meme reference_id | Doublon detecte | Renvoyer le 1er resultat |
La regle d'or : verifier le statut avant de capturer. Ne jamais relancer un requestToPay sur timeout ; interroger d'abord le statut par externalId. Si le paiement est deja SUCCESSFUL, on a evite un double debit. S'il est FAILED, alors seulement on propose de reessayer — avec une nouvelle cle si c'est vraiment une nouvelle intention.
Mini cas pratique
Aminata gere une boutique en ligne a Dakar. En mai 2026, elle traite 5 000 paiements. Statistiquement, environ 60 paiements (1,2 %) subissent un double clic. Sans idempotence, cela ferait 60 clients debites deux fois, soit — a un panier moyen de 12 000 FCFA — 720 000 FCFA a rembourser, et 60 clients furieux.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
Apres mise en place de la cle d'idempotence par intention d'achat, la seconde collecte de chaque doublon est ignoree : zero double debit. Sur les rares cas de timeout USSD, son code verifie le statut par externalId avant toute recapture, ce qui rattrape encore une dizaine de paiements qui auraient semble echouer. Bilan : 0 FCFA de remboursement pour double debit, et un taux de reclamation paiement divise par plus de dix.
Devenez apporteur d'affaires Kolonell
Vous connaissez des commerçants, restaurateurs ou entrepreneurs qui perdent des ventes a cause de paiements peu fiables ? Recommandez-les et gagnez une commission sur chaque projet signe. Le programme apporteur d'affaires Kolonell est simple et transparent.
| Type de projet recommande | Commission a la vente | Commission recurrente |
|---|---|---|
| Site vitrine | 15 % | 5 % sur maintenance/SEO |
| E-commerce (Wave/OM) | 12 % | 5 % sur maintenance/SEO |
| Marketplace | 10 % | — |
| Institutionnel | 8 % | — |
Concretement : recommander un projet e-commerce a 2 000 000 FCFA vous rapporte 240 000 FCFA de commission, plus 5 % recurrent si le client prend la maintenance. Aucune competence technique requise : vous ouvrez la porte, Kolonell livre, vous touchez.
FAQ
Qu'est-ce qu'une cle d'idempotence exactement ? C'est un identifiant unique genere par intention d'achat, pas par clic, envoye a chaque tentative de paiement. Si deux requetes portent la meme cle, l'operateur traite une seule collecte : les 1,2 % de doubles clics deviennent inoffensifs.
Faut-il regenerer la cle a chaque reessai ? Non pour un reessai de la meme intention : gardez la meme cle pour qu'un doublon soit detecte. Ne generez une nouvelle cle que si le client relance volontairement un achat apres un echec confirme.
Que faire pendant le timeout USSD de 60 s ? Ne rien recollecter. Verifier le statut par externalId : si le paiement est deja SUCCESSFUL, vous avez evite un double debit ; s'il est FAILED, proposez un reessai propre.
L'idempotence protege-t-elle aussi les webhooks ? Oui : la meme logique par transaction_id absorbe les 2 % de webhooks rejoues sans double credit. C'est la meme discipline appliquee cote reception.
Combien un double debit coute-t-il vraiment ? Au-dela du montant a rembourser, il coute la confiance : un client debite deux fois revient rarement. Eviter 720 000 FCFA de remboursements sur 5 000 paiements est autant une question d'image que d'argent.
Discutons de votre projet. On securise vos paiements avec l'idempotence pour eliminer tout double debit — et si vous nous recommandez un client, vous touchez jusqu'a 15 % de commission. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
