Le verdict en trois phrases
Un SDK front bien encapsulé fait passer le temps d'intégration d'un paiement mobile de plusieurs jours à quelques heures. Au Togo, un hook React usePayment centralise la machine à états (pending, success, failed), le polling du statut et le retry UI, pour T-Money comme pour Moov. La décision structurante est SDK propriétaire réutilisable ou composant custom jetable : le SDK gagne dès le deuxième projet.
SDK propriétaire ou composant custom : l'arbitrage pour l'équipe
Un composant custom écrit pour un seul projet semble plus rapide au départ. Mais dès qu'un deuxième site doit encaisser, vous recopiez la logique, les bugs et la dette. Un SDK versionné inverse l'équation.
| Critère | SDK propriétaire | Composant custom |
|---|---|---|
| Temps 1er projet | 1 jour | 0,5 jour |
| Temps 2e projet | 2 heures | 0,5 jour |
| Corrections mutualisées | Oui (une version) | Non (copié-collé) |
| Tests centralisés | Oui | Par projet |
| Machine à états | Réutilisable | Réécrite |
| Recommandé pour | Agence, multi-projets | Prototype unique |
Pour une agence ou une équipe qui livre plusieurs boutiques par an, le SDK amortit son coût dès la deuxième intégration.
Les états UI, le polling et la gestion d'erreurs en 2026
Le cœur du SDK est une machine à états claire côté React, alimentée par un polling du statut serveur. Voici les valeurs recommandées pour le Togo en 2026.
| Élément | Valeur 2026 | Rôle |
|---|---|---|
| État initial | idle | Avant clic |
| État en cours | pending | Attente confirmation |
| Intervalle de polling | 3 secondes | Interroge status() |
| Timeout global | 90 secondes | Bascule en failed |
| État final succès | success | Affiche le reçu |
| État final échec | failed | Propose retry |
| Nombre de retries UI | 2 | Avant abandon |
| Opérateurs | T-Money, Moov Togo | Sélection au checkout |
Règle : le front ne décide jamais du succès seul, il reflète le statut renvoyé par le backend, lui-même confirmé par le webhook opérateur.
Comparaison avec le Rwanda (Kigali)
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.
À Kigali, la même approche s'applique avec MTN MoMo et Airtel Money : un hook React, un polling du statut, un timeout adapté au temps de saisie du PIN USSD.
| Critère | SDK Togo (T-Money, Moov) | SDK Rwanda (MTN, Airtel) |
|---|---|---|
| Hook | usePayment | usePayment |
| Opérateurs | T-Money, Moov | MTN MoMo, Airtel |
| Intervalle polling | 3 s | 3 s |
| Timeout global | 90 s | 90 s |
| Devise | XOF (FCFA) | RWF |
| Retry UI | 2 | 2 |
Mini cas pratique
Kodjo dirige un petit studio web à Lomé qui livre 5 boutiques React par an. Sans SDK, chaque intégration paiement lui coûtait 3 jours-homme, soit 15 jours par an. Après avoir encapsulé un SDK usePayment réutilisable (1,5 jour d'investissement initial), chaque nouvelle intégration tombe à 3 heures. Sur 5 projets, il passe de 15 jours à environ 3,4 jours : plus de 11 jours-homme économisés par an, réinvestis dans la conversion et l'UX.
FAQ
Pourquoi un SDK plutôt qu'un composant custom ? Parce qu'un composant custom est recopié à chaque projet, avec ses bugs. Un SDK versionné mutualise corrections et tests : dès le deuxième projet, l'intégration tombe de 0,5 jour à 2 heures.
Quel intervalle de polling choisir ? 3 secondes est le bon équilibre en 2026 : assez réactif pour l'acheteur, assez espacé pour ne pas marteler l'API status(). Avec un timeout global de 90 secondes, vous couvrez la saisie du PIN USSD.
Le front peut-il décider seul du succès ? Non. Le hook reflète uniquement le statut renvoyé par le backend, lui-même confirmé par le webhook opérateur. Le SDK affiche, il ne valide pas le paiement.
Combien de retries UI prévoir ? Deux avant abandon, pour couvrir les erreurs de saisie ou les timeouts réseau sans frustrer l'acheteur. Chaque retry relance proprement la machine à états depuis pending.
Le même SDK marche-t-il au Rwanda ? Oui, la structure est identique : hook usePayment, polling 3 s, timeout 90 s. Seuls changent les opérateurs (MTN MoMo, Airtel) et la devise (RWF au lieu du FCFA).
Discutons de votre projet. Nous encapsulons un SDK de paiement React réutilisable pour T-Money et Moov au Togo, prêt à câbler sur toutes vos boutiques. 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.
