Skip to main content

​
Qué es

El sandbox de NTX Pay permite que tu integración ejercite cash-in, cash-out, devoluciones y webhooks sin mover dinero real. Se ejercita el pipeline completo — saldo, validación de límites, cobro de tarifas, estado de cuenta y entrega de webhooks — solo la liquidación en la red SPEI es simulada.
La integración no cambia. Los endpoints, payloads y webhooks son exactamente los descritos en las guías — cuando producción sea habilitada para tu empresa, el mismo código funcionará con solo cambiar las credenciales. Por eso, esta sección documenta únicamente lo que es diferente en el sandbox: los escenarios de prueba y los webhooks simulados.

​
Cómo activarlo

Tus credenciales de API son estructuralmente las mismas que usarías en producción. La diferencia vive en la cuenta: las cuentas sandbox enrutan las llamadas SPEI al simulador interno de NTX Pay. Para crear una cuenta sandbox, pídelo a tu Account Manager o escribe a contact@ntxpay.com — el onboarding es instantáneo y el KYC se aprueba automáticamente.
Las credenciales de sandbox son distintas de las de producción. Las credenciales de producción contra el host de sandbox devuelven 401. La autenticación en sí es idéntica.

​
Base URL

Todas las rutas documentadas (/api/auth/token, /api/spei/cash-in, /api/spei/cash-out, /api/balance, /api/webhooks-config) están disponibles exactamente en este host.

​
Diferencias vs Producción

​
Flujo de prueba sugerido

  1. Autentícate — obtén el JWT con las credenciales sandbox.
  2. Registra tu webhook — vía POST /api/webhooks-config, exactamente como en producción.
  3. Crea un cash-in — sigue la guía de cash-in; la confirmación llega simulada en segundos.
  4. Envía un cash-out — con el saldo del paso anterior, sigue la guía de cash-out.
  5. Fuerza errores y devoluciones — usa los escenarios para ejercitar todos los caminos de tu handler.

​
Próximos pasos

Escenarios de prueba

Fuerza éxito, falla, devolución y retraso vía header X-Sandbox-Scenario.

Webhooks simulados

Cómo disparar cada evento y validar dedupe, retry y firma.

​
Soporte

suporte@ntxpay.com