Sandbox Mobile Money

Comportement PROCESSING, polling /status et bonnes pratiques en environnement test.

Flux asynchrone

Après POST /checkout/pay/:sessionId/complete, la réponse peut être status PROCESSING avec nextAction POLL.

Interrogez GET /checkout/pay/:sessionId/status toutes les pollAfterMs millisecondes (souvent ~4 200 ms) jusqu'à SUCCEEDED, FAILED ou EXPIRED.

Expiration de session

Une session ouverte expire environ 30 minutes après création (expiresAt). Au-delà, /status renvoie EXPIRED et la session n'est plus payable.

Un paiement Mobile Money en PROCESSING depuis plus de 10 minutes sans confirmation provider passe en FAILED (failureCode PAYMENT_NOT_CONFIRMED).

Bonnes pratiques

  • Une session active par numéro de téléphone : évitez les rafales de /complete sur le même MSISDN.
  • Réutilisez le sessionToken retourné à la création de session (header X-Checkout-Session-Token) en production sur /complete et /select-method.
  • Les routes publiques /complete et /select-method sont limitées (5 requêtes / 15 min par session, numéro et IP).

Numéros de test

IZZIPAY ne publie pas encore de fiche de numéros sandbox garantissant succès ou échec. Utilisez vos propres MSISDN de test sandbox PawaPay jusqu'à publication d'une liste officielle.