> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.ntxpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros Passos

> Boas-vindas à API NTX Pay México. Este guia te leva pelos primeiros passos para integrar e começar a usar SPEI.

## 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

<Steps>
  <Step title="Solicite uma conta sandbox">
    Contate seu gerente de conta ou escreva para `contact@ntxpay.com` solicitando uma conta sandbox.
  </Step>

  <Step title="Receba suas credenciais">
    Você receberá um **certificado** e as **credenciais OAuth** (`clientId` + `clientSecret`) associadas à conta sandbox.
  </Step>

  <Step title="Registre a URL do webhook">
    Registre a URL do seu webhook via `POST /api/webhooks-config` para receber eventos simulados.

    ```bash theme={"system"}
    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"]
      }'
    ```
  </Step>

  <Step title="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.).

    ```bash theme={"system"}
    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"
      }'
    ```
  </Step>
</Steps>

## Ambiente

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

## Trilha de Integração

<CardGroup cols={2}>
  <Card title="Autenticação" href="/pt-br/guides/authentication">
    Certificado + OAuth 2.0 para obter o JWT
  </Card>

  <Card title="SPEI Cash-In" href="/pt-br/guides/spei-cash-in">
    Receba pagamentos via CLABE descartável
  </Card>

  <Card title="Webhooks" href="/pt-br/guides/webhooks/overview">
    Receba notificações de cada evento
  </Card>

  <Card title="Sandbox" href="/pt-br/sandbox/introduction">
    Cenários de teste e webhooks simulados
  </Card>
</CardGroup>

## Suporte

`suporte@ntxpay.com`