Visão Geral
A API NTX Pay México usa autenticação em duas camadas:- Certificado — entregue pelo NTX Pay no onboarding, comprova a identidade do servidor cliente.
- OAuth 2.0 client_credentials —
clientId+clientSecretfornecidos no onboarding, validados em conjunto com o certificado.
Authorization: Bearer ....
A autenticação no sandbox é idêntica — o que muda é o par certificado +
clientId/clientSecret, que é distinto do de produção. Credenciais de produção contra https://sandbox.mx.ntxpay.com retornam 401.Endpoint
POST /api/auth/token
Headers Obrigatórios
X-SSL-Client-Cert é tipicamente injetado pelo NGINX/ALB com o certificado URL-encoded:
Request
Response (201)
Usando o Token
Inclua oaccess_token em todas as requisições autenticadas:
Renovação
O token expira em 10 minutos (600s). Repita o passo 1 antes de expirar — não há refresh token.Erros Comuns
Exemplos de Código
Próximos Passos
Consulta de Saldo
Aplique o token Bearer e consulte o saldo da conta
SPEI Cash-In
Faça sua primeira cobrança SPEI