Numéros Mobile Money de test

En Sandbox, utilisez ces numéros de téléphone prédéfinis pour simuler différents scénarios de paiement Mobile Money sans aucun débit réel. Aucun push USSD n’est envoyé — la confirmation est simulée automatiquement selon le numéro utilisé.

Airtel Money — Numéros de test

Numéro	Comportement simulé	Code d'erreur
`+24177000001`	✅ Paiement réussi immédiatement	—
`+24177000002`	❌ Fonds insuffisants	`INSUFFICIENT_FUNDS`
`+24177000003`	⏱ Timeout (acheteur ne confirme pas)	`MOBILE_MONEY_TIMEOUT`
`+24177000004`	❌ Numéro non enregistré	`MOBILE_MONEY_NUMBER_INVALID`
`+24177000005`	⏳ Traitement lent (30 secondes)	—
`+24177000006`	⏳ Traitement lent (60 secondes)	—

Moov Money — Numéros de test

Numéro	Comportement simulé	Code d'erreur
`+24166000001`	✅ Paiement réussi immédiatement	—
`+24166000002`	❌ Fonds insuffisants	`INSUFFICIENT_FUNDS`
`+24166000003`	❌ Numéro non enregistré Moov Money	`MOBILE_MONEY_NUMBER_INVALID`
`+24166000004`	⏱ Timeout	`MOBILE_MONEY_TIMEOUT`

Ces codes sont documentés en détail sur la page Codes d’erreur.

Webhooks actifs en Sandbox

Les webhooks sont bien déclenchés en Sandbox. Un paiement réussi avec +24177000001 émettra un événement payment_intent.succeeded sur votre endpoint de test, exactement comme en production.

Les numéros de test sont-ils clairs ?

Exemple — Paiement Airtel réussi

meth_xxxx ci-dessous est l’ID du PaymentMethod Mobile Money créé pour le client lors du passage en caisse (checkout hébergé) — c’est la page de paiement qui collecte le numéro et crée ce PaymentMethod. En Sandbox, saisissez l’un des numéros de test ci-dessus sur cette page pour déclencher le scénario correspondant.

bash

# 1. Créer le PaymentIntent
curl -X POST https://api.sangho.ga/v1/payment-intents/ \
  -H "Authorization: Bearer sk_test_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XAF",
    "payment_method_types": ["mobile_money"]
  }'


# 2. Confirmer le paiement une fois le PaymentMethod créé par le checkout
#    (saisir +24177000001 sur la page de paiement déclenche un succès immédiat)
curl -X POST https://api.sangho.ga/v1/payment-intents/pi_xxxx/confirm/ \
  -H "Authorization: Bearer sk_test_xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "payment_method": "meth_xxxx" }'

Réinitialiser le Sandbox

L’endpoint de reset supprime toutes les données de test associées à votre clé sandbox — PaymentIntents, transactions, customers, webhooks de test, etc. Utile pour repartir d’un état propre avant une démonstration ou un cycle de tests.

Opération irréversible

La réinitialisation Sandbox supprime définitivement toutes les données de test. Cette opération est irréversible — aucune restauration n’est possible.

La section reset est-elle claire ?

Réinitialiser le Sandbox

bash

curl -X POST https://api.sangho.ga/v1/reset/ \
  -H "Authorization: Bearer sk_test_xxxx"

Response200 OK — Sandbox réinitialisé

Toutes les données de test ont été supprimées. Votre environnement Sandbox est vierge.

json

{
  "object": "sandbox_reset",
  "reset_at": "2026-03-01T10:00:00Z",
  "livemode": false
}