Qué es
El sandbox de NTX Pay permite que tu integración ejercite cash-in, cash-out, refund y webhooks sin mover dinero real. A diferencia de mocks simples, el pipeline contable completo (saldo TigerBeetle, validación de límites, cobro de tarifas, generación de extractos, entrega de webhooks vía outbox) se ejercita intacto. Solo el provider externo (SPEI/Banxico) es simulado.Toda integración con NTX Pay empieza por el sandbox. Los endpoints, payloads y webhooks descritos en esta documentación son los definitivos — cuando producción se habilite para tu empresa, el mismo código funcionará simplemente cambiando las credenciales.
Cómo activar
Tus credenciales de API son estructuralmente las mismas que usarías en producción. La diferencia vive en la cuenta: las cuentas conmainProvider: "sandbox" enrutan toda llamada SPEI internamente al simulador NTX. Para crear una cuenta sandbox, contacta a tu Account Manager o escribe a contact@ntxpay.com — el onboarding es instantáneo y el KYC es auto-aprobado.
Base URL
| Ambiente | URL |
|---|---|
| Sandbox | https://sandbox.mx.ntxpay.com |
/api/auth/token, /api/spei/cash-in, /api/spei/cash-out, /api/transactions, /api/webhooks-config) están disponibles exactamente en este host.
Escenarios de prueba
Controlas el comportamiento de cada llamada vía el header HTTPX-Sandbox-Scenario. Sin el header, el sandbox devuelve éxito por defecto. Mira Escenarios para la lista completa de escenarios de error, éxito y atraso soportados.
Webhooks
Registra tuwebhookUrl en la cuenta sandbox exactamente como lo harías en producción — vía POST /api/webhooks-config. Los eventos son entregados por el mismo motor de outbox que usamos en prod, con las mismas firmas, headers (X-NTXPay-Delivery) y política de retry.
Diferencias vs Producción
| Aspecto | Sandbox | Producción |
|---|---|---|
| Base URL | https://sandbox.mx.ntxpay.com | Provista en el onboarding |
| Provider | sandbox (simulado) | Banco real (Banxico/SPEI) |
| Saldo | Simulado | Fondos reales |
| Confirmación SPEI cash-in | Inmediata (~1s) | Real (segundos a minutos) |
X-Sandbox-Scenario | Soportado | Rechazado con 400 |
| Costo | Gratis | Según contrato |
Próximos pasos
Autenticación
Cómo obtener el JWT en sandbox usando tus credenciales.
Escenarios
Lista completa de escenarios disponibles vía
X-Sandbox-Scenario.Cash-in
Recibir vía SPEI en sandbox.
Cash-out
Enviar vía SPEI en sandbox.
Webhooks
Cómo el sandbox entrega webhooks y cómo probar dedupe.
Soporte
contact@ntxpay.com