Saltar al contenido principal

​
Overview

La API NTX Pay México permite que tu empresa realice operaciones de pago, consulte saldos, reconcilie transacciones y reciba notificaciones por webhooks — todo de forma segura y escalable. La autenticación es vía certificado X.509 (mTLS) + OAuth 2.0, devolviendo un JWT de corta duración para cada request.

​
Getting Started with Sandbox

1

Solicita una cuenta de sandbox

Contacta a tu account manager o escribe a contact@ntxpay.com para solicitar una cuenta de sandbox.
2

Recibe tus credenciales

Recibirás un certificado y las credenciales OAuth (clientId + clientSecret) asociadas a la cuenta de sandbox.
3

Registra la URL del webhook

Registra la URL de tu webhook vía POST /api/webhooks-config para recibir eventos simulados.
curl -X POST https://sandbox.ntxpay.com/api/webhooks-config \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://mi-servidor.com/webhooks/ntxpay",
    "events": ["cash_in", "cash_out"]
  }'
4

Confirma el modo sandbox en el panel

En el dashboard, ve a Settings para confirmar que tu cuenta está configurada en modo sandbox.
5

Autentica y simula escenarios

Autentica, realiza las llamadas a la API y usa el header X-Sandbox-Scenario para simular diferentes resultados (confirmación inmediata, falla, expiración, etc.).
curl -X POST https://sandbox.ntxpay.com/api/spei/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Sandbox-Scenario: cash_in_failed" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCentavos": 50000,
    "externalId": "order-001",
    "customerName": "Juan Perez"
  }'

​
Ambientes

AmbienteURLProvider
Sandboxhttps://sandbox.ntxpay.comsandbox (transacciones simuladas)
Producciónhttps://api.ntxpay.comsmartfastpay

​
Soporte

contact@ntxpay.com · https://app.ntxpay.com