# NTX Pay API

## Docs

- [Gerar JWT access token](https://docs.mx.ntxpay.com/pt-br/endpoints/generate-token.md): **Requer certificado X.509 no header `X-SSL-Client-Cert` (URL-encoded PEM)**. Autentica via certificado + clientId/clientSecret e retorna um JWT para uso nos demais endpoints.
- [Criar cobrança OXXO (cash-in)](https://docs.mx.ntxpay.com/pt-br/endpoints/oxxo-cash-in.md): **Requer Bearer JWT**. Gera código de barras / cupom OXXO para pagamento em dinheiro nas lojas da rede OXXO. Confirmação após a leitura no caixa (delay típico de minutos a horas).
- [Criar cobrança SPEI (cash-in)](https://docs.mx.ntxpay.com/pt-br/endpoints/spei-cash-in.md): **Requer Bearer JWT**. Gera uma CLABE descartável de destino que o pagador deve usar em uma transferência SPEI. Confirmação assíncrona via webhook `cash_in`.
- [Enviar SPEI (cash-out)](https://docs.mx.ntxpay.com/pt-br/endpoints/spei-cash-out.md): **Requer Bearer JWT**. Envia transferência SPEI para uma CLABE de destino. Confirmação assíncrona via webhook `cash_out`.
- [Consultar transação SPEI por externalId / conciliationId](https://docs.mx.ntxpay.com/pt-br/endpoints/spei-transaction.md): **Requer Bearer JWT**. Retorna UM registro SPEI da conta autenticada. Aceita o `externalId` enviado no cash-in/cash-out original. Compatível com `GET /api/v1/transaction/{conciliationId}/conciliation` da Voluti SPEI.
- [Remover webhook](https://docs.mx.ntxpay.com/pt-br/endpoints/webhooks-config-delete.md): **Requer Bearer JWT**.
- [Listar webhooks da conta](https://docs.mx.ntxpay.com/pt-br/endpoints/webhooks-config-list.md): **Requer Bearer JWT**.
- [Configurar webhook](https://docs.mx.ntxpay.com/pt-br/endpoints/webhooks-config-setup.md): **Requer Bearer JWT**. URL HTTPS + lista de eventos (1-5) + secret opcional para assinatura HMAC. Se `secret` for omitido, o NTX Pay gera um automaticamente e retorna na resposta — guarde com segurança.
- [Autenticação](https://docs.mx.ntxpay.com/pt-br/guides/authentication.md): Certificado + OAuth 2.0 client_credentials para obter JWT de acesso
- [Primeiros Passos](https://docs.mx.ntxpay.com/pt-br/guides/get-started.md): Boas-vindas à API NTX Pay México. Este guia te leva pelos primeiros passos para integrar e começar a usar SPEI e OXXO.
- [Coleções Postman](https://docs.mx.ntxpay.com/pt-br/guides/postman-collections.md): Importe a coleção oficial do Postman para testar a API NTX Pay localmente.
- [Testes em Sandbox](https://docs.mx.ntxpay.com/pt-br/guides/sandbox-testing.md): Como usar o ambiente sandbox do NTX Pay México para simular cenários SPEI e OXXO sem custo nem risco.
- [Evento cash_in](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/cash-in.md): Notificação enviada quando um SPEI ou OXXO cash-in é confirmado
- [Evento cash_out](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/cash-out.md): Notificação enviada quando um SPEI cash-out é liquidado ou falha
- [Implementação de Webhook](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/implementation.md): Validação HMAC e processamento idempotente em Node.js, Python, Java e Go
- [Visão Geral de Webhooks](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/overview.md): Notificações automáticas para eventos SPEI e OXXO
- [Evento refund_in](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/refund-in.md): Notificação de estorno recebido — uma transferência cash-out sua foi devolvida
- [Evento refund_out](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/refund-out.md): Notificação de estorno enviado — você devolveu uma transação cash-in recebida
- [Setup de Webhooks](https://docs.mx.ntxpay.com/pt-br/guides/webhooks/setup.md): Configure URLs de webhook programaticamente para SPEI e OXXO

## OpenAPI Specs

- [openapi](https://docs.mx.ntxpay.com/api-reference/openapi.json)