Skip to main content

​
O que é

O sandbox NTX Pay permite que sua integração exercite cash-in, cash-out, devoluções e webhooks sem mover dinheiro real. O pipeline completo é exercitado — saldo, validação de limites, cobrança de tarifas, extrato e entrega de webhooks — apenas a liquidação na rede SPEI é simulada.
A integração não muda. Os endpoints, payloads e webhooks são exatamente os descritos nos guias — quando produção for liberada para a sua empresa, o mesmo código funcionará apenas trocando as credenciais. Por isso, esta seção documenta somente o que é diferente no sandbox: os cenários de teste e os webhooks simulados.

​
Como ativar

Suas credenciais de API são as mesmas estruturalmente que você usaria em produção. A diferença vive na conta: contas sandbox roteiam as chamadas SPEI para o simulador interno da NTX Pay. Para criar uma conta sandbox, peça ao seu Account Manager ou escreva para contact@ntxpay.com — o onboarding é instantâneo e o KYC é auto-aprovado.
As credenciais de sandbox são distintas das de produção. Credenciais de produção contra o host de sandbox retornam 401. A autenticação em si é idêntica.

​
Base URL

Todas as rotas documentadas (/api/auth/token, /api/spei/cash-in, /api/spei/cash-out, /api/balance, /api/webhooks-config) estão disponíveis exatamente neste host.

​
Diferenças vs Produção

​
Fluxo de teste sugerido

  1. Autentique — obtenha o JWT com as credenciais sandbox.
  2. Registre seu webhook — via POST /api/webhooks-config, exatamente como em produção.
  3. Crie um cash-in — siga o guia de cash-in; a confirmação chega simulada em segundos.
  4. Envie um cash-out — com o saldo do passo anterior, siga o guia de cash-out.
  5. Force erros e devoluções — use os cenários para exercitar todos os caminhos do seu handler.

​
Próximos passos

Cenários de teste

Force sucesso, falha, devolução e atraso via header X-Sandbox-Scenario.

Webhooks simulados

Como disparar cada evento e validar dedupe, retry e assinatura.

​
Suporte

suporte@ntxpay.com