URLs base
| Ambiente | Base URL | Use para |
|---|---|---|
| Sandbox | https://api-sandbox.pagou.ai | desenvolvimento local, testes automatizados, validação em staging |
| Production | https://api.pagou.ai | tráfego real, reconciliação em produção, fluxos operacionais |
Regras
- Separe os tokens de sandbox e produção.
- Use endpoints diferentes de webhook para sandbox e produção.
- Nunca exponha credenciais de produção no código do navegador.
- Faça rollout trocando apenas configuração: token, base URL, destino de webhook e monitoramento.
Por que isso importa
Diferença entre ambientes é uma causa comum de erro em lançamento. Se o formato das requisições for igual nos dois ambientes, a entrada em produção vira uma mudança operacional, não um risco de deploy de código.Checklist de liberação
- Valide a autenticação em sandbox.
- Rode um fluxo feliz completo com Pix, voucher ou cartão.
- Confirme entrega de webhook, deduplicação e reconciliação.
- Verifique se os logs guardam
requestId, IDs de recurso e seuexternal_ref. - Na entrada em produção, troque apenas credenciais e base URL.