Números de Mobile Money de prueba

En el Sandbox, utilice estos números de teléfono predefinidos para simular distintos escenarios de pago con Mobile Money sin ningún cargo real. No se envía ningún push USSD: la confirmación se simula automáticamente según el número utilizado.

Airtel Money — Números de prueba

Número	Comportamiento simulado	Código de error
`+24177000001`	✅ Pago correcto de inmediato	—
`+24177000002`	❌ Fondos insuficientes	`INSUFFICIENT_FUNDS`
`+24177000003`	⏱ Timeout (el comprador no confirma)	`MOBILE_MONEY_TIMEOUT`
`+24177000004`	❌ Número no registrado	`MOBILE_MONEY_NUMBER_INVALID`
`+24177000005`	⏳ Procesamiento lento (30 segundos)	—
`+24177000006`	⏳ Procesamiento lento (60 segundos)	—

Moov Money — Números de prueba

Número	Comportamiento simulado	Código de error
`+24166000001`	✅ Pago correcto de inmediato	—
`+24166000002`	❌ Fondos insuficientes	`INSUFFICIENT_FUNDS`
`+24166000003`	❌ Número no registrado en Moov Money	`MOBILE_MONEY_NUMBER_INVALID`
`+24166000004`	⏱ Timeout	`MOBILE_MONEY_TIMEOUT`

Estos códigos se documentan en detalle en la página de Códigos de error.

Webhooks activos en el Sandbox

Los webhooks sí se disparan en el Sandbox. Un pago correcto con +24177000001 emitirá un evento payment_intent.succeeded en su endpoint de prueba, exactamente igual que en producción.

¿Están claros los números de prueba?

Ejemplo — Pago correcto con Airtel

meth_xxxx a continuación es el ID del PaymentMethod de Mobile Money creado para el cliente durante el paso por caja (checkout alojado): es la página de pago la que recoge el número y crea ese PaymentMethod. En el Sandbox, introduzca uno de los números de prueba anteriores en esa página para activar el escenario correspondiente.

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" }'

Restablecer el Sandbox

El endpoint de restablecimiento elimina todos los datos de prueba asociados a su clave sandbox (PaymentIntents, transacciones, customers, webhooks de prueba, etc.). Resulta útil para empezar de nuevo desde un estado limpio antes de una demostración o de un ciclo de pruebas.

Operación irreversible

El restablecimiento del Sandbox elimina definitivamente todos los datos de prueba. Esta operación es irreversible: no es posible ninguna restauración.

¿Está clara la sección de restablecimiento?

Restablecer el Sandbox

bash

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

Response200 OK — Sandbox restablecido

Se han eliminado todos los datos de prueba. Su entorno Sandbox está vacío.

json

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