Le verdict en trois phrases
Un paiement « en attente » n'est ni un succès ni un échec : c'est un état temporaire entre le débit tenté et la confirmation. La bonne pratique 2026 est une fenêtre d'expiration (typiquement 2 à 15 min) avec polling automatique, jamais une décision manuelle à l'aveugle. Statistiquement, environ 92 % des pending se résolvent en succès — la clé est de ne rien libérer ni annuler avant l'issue définitive.
Pourquoi un paiement reste en attente
Les causes sont presque toujours côté réseau ou côté client, rarement un bug de votre code. Un USSD lent, un PIN saisi en retard, un provider saturé : le paiement flotte quelques minutes.
| Cause | Fréquence relative | Fenêtre typique | Issue probable |
|---|---|---|---|
| Réseau USSD lent | élevée | 2-5 min | succès |
| PIN non saisi à temps | moyenne | 3-10 min | échec (timeout) |
| Provider saturé (pic) | variable | 5-15 min | succès différé |
| Solde insuffisant | faible | immédiat | échec |
| Client abandonne | moyenne | 15 min max | expiration |
Règle : ne montrez jamais « échec » avant l'expiration de la fenêtre. Un client qui voit « échec » alors que son paiement va aboutir va souvent repayer — et vous voilà avec un double débit.
La politique de statut à trois états
Une commande transite par trois états clairs. Le passage se fait par webhook OU par polling getStatus, jamais à la main.
| Statut | Signification | Action système | Message client |
|---|---|---|---|
| pending | Paiement en cours | Bloquer stock, ne rien expédier | « Paiement en cours, patientez… » |
| success | Confirmé | Valider commande, libérer prépa | « Paiement confirmé ✓ » |
| failed | Échoué/expiré | Libérer stock, proposer réessai | « Échec, réessayez » |
La fenêtre de sécurité : après 15 minutes sans confirmation, marquez failed, relâchez le stock réservé, et invitez au réessai. Traitez les rares confirmations tardives comme des orphelins à réconcilier.
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.
Mini cas pratique
Fatou vend des tissus en ligne à Thiès : 900 commandes/mois. Environ 7 % passent par un état pending, soit 63 commandes/mois. Au début, elle annulait tout pending après 3 min : elle perdait ≈ 40 % de ventes qui allaient pourtant aboutir, soit 25 commandes × 15 000 FCFA = 375 000 FCFA/mois évaporés. En allongeant la fenêtre à 12 min avec polling getStatus toutes les 30 s, 92 % des pending se sont confirmés. Ventes récupérées : ~350 000 FCFA/mois, sans un seul double débit.
FAQ
Combien de temps laisser une commande en attente ? En 2026, une fenêtre de 2 à 15 minutes couvre la quasi-totalité des cas. Au-delà de 15 min, marquez l'échec et libérez le stock ; les confirmations plus tardives se traitent en réconciliation.
Faut-il expédier une commande pending ? Jamais. Le statut pending signifie que l'argent n'est pas confirmé. Attendez success ; expédier un pending revient à offrir la marchandise si le paiement échoue.
Quel message afficher au client ? Un message rassurant et actif : « Paiement en cours de validation, ne fermez pas cette page… ». Évitez « échec » prématuré, qui pousse au repaiement et donc au double débit.
Quelle proportion de pending finit en succès ? Ordre de grandeur 2026 : environ 90 à 92 % avec une fenêtre correcte et du polling. Les 8-10 % restants sont de vrais échecs (timeout PIN, solde insuffisant, abandon).
Comment gérer les confirmations arrivées trop tard ? Traitez-les comme des orphelins : rapprochez-les de vos ventes non honorées, contactez le client, et honorez ou remboursez. Un bon journal de transactions rend ce traitement trivial.
Discutons de votre projet. Nous implémentons une gestion des pending propre : fenêtre, polling et messages clients clairs. 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.
