Primeiros Passos

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

Solicite uma conta sandbox

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

Receba suas credenciais

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

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.mx.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"]
  }'

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.mx.ntxpay.com/api/spei/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Sandbox-Scenario: rejected" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCentavos": 50000,
    "externalId": "order-001",
    "customerName": "Juan Perez",
    "customerEmail": "juan@example.com"
  }'

Ambiente

Ambiente	URL
Sandbox	`https://sandbox.mx.ntxpay.com`
Produção	`https://api.mx.ntxpay.com`

Trilha de Integração

Autenticação

Certificado + OAuth 2.0 para obter o JWT

SPEI Cash-In

Receba pagamentos via CLABE descartável

Webhooks

Receba notificações de cada evento

Sandbox

Cenários de teste e webhooks simulados

Suporte

suporte@ntxpay.com

Guia

Sandbox

Webhooks

Autenticação

SPEI

Webhooks Config

Visão Geral

Passo a Passo no Sandbox

Ambiente

Trilha de Integração

Autenticação

SPEI Cash-In

Webhooks

Sandbox

Suporte

​Visão Geral

​Passo a Passo no Sandbox

​Ambiente

​Trilha de Integração

Autenticação

SPEI Cash-In

Webhooks

Sandbox

​Suporte

Visão Geral

Passo a Passo no Sandbox

Ambiente

Trilha de Integração

Suporte