> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> Escolha a URL base, as credenciais e a disciplina de implantação para sandbox e produção.

Use o mesmo código de integração nos dois ambientes. Troque configuração, não comportamento.

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

1. Valide a autenticação em sandbox.
2. Rode um fluxo feliz completo com Pix, voucher ou cartão.
3. Confirme entrega de webhook, deduplicação e reconciliação.
4. Verifique se os logs guardam `requestId`, IDs de recurso e seu `external_ref`.
5. Na entrada em produção, troque apenas credenciais e base URL.

## Próximos passos

* [Autenticação](/pt/start-here/authentication)
* [Checklist de entrada em produção](/pt/start-here/go-live-checklist)