Pular para o conteúdo principal

​
Visão Geral

A API NTX Pay México permite que sua empresa realize operações de pagamento, reconcilie transações e receba notificações por webhooks — tudo de forma segura e escalável. A autenticação é via certificado X.509 (mTLS) + OAuth 2.0, retornando um JWT de curta duração para cada requisição.

​
Passo a Passo no Sandbox

1

Solicite uma conta sandbox

Contate seu gerente de conta ou escreva para contact@ntxpay.com solicitando uma conta sandbox.
2

Receba suas credenciais

Você receberá um certificado e as credenciais OAuth (clientId + clientSecret) associadas à conta sandbox.
3

Registre a URL do webhook

Registre a URL do seu webhook via POST /api/webhooks-config para receber eventos simulados.
curl -X POST https://sandbox.ntxpay.com/api/webhooks-config \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://meu-servidor.com/webhooks/ntxpay",
    "events": ["cash_in", "cash_out"]
  }'
4

Autentique e simule cenários

Autentique, faça chamadas à API e use o header X-Sandbox-Scenario para simular diferentes resultados (confirmação imediata, falha, expiração, etc.).
curl -X POST https://sandbox.ntxpay.com/api/spei/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Sandbox-Scenario: error:insufficient-funds" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCentavos": 50000,
    "externalId": "order-001",
    "customerName": "Juan Perez"
  }'

​
Ambiente

AmbienteURLProvider
Sandboxhttps://sandbox.ntxpay.comsandbox (transações simuladas)

​
Suporte

support@ntxpay.com