O Pagozz possui dois ambientes completamente isolados, determinados automaticamente pelo prefixo da sua API key.
Test vs Live
| Test | Live |
|---|
| Chave | pgz_test_* | pgz_live_* |
| PIX | Simulado (sem Woovi) | Real via Woovi |
| QR Code | Placeholder | Código PIX real |
| Confirmação | Via simulação (API ou painel) | Via webhook do provedor |
| Webhooks | Disparados normalmente | Disparados normalmente |
| Saldo | Independente | Real |
Dados de test e live são completamente separados. Links, transações e webhooks de um ambiente não aparecem no outro.
Como funciona
O ambiente é determinado em dois contextos:
API
O prefixo da chave no header Pagozz-Token define o ambiente:
# Requisição no ambiente test
curl https://api.pagozz.com/v1/links \
-H "Pagozz-Token: pgz_test_XXXXXXXXXXXXXXXXXXXXXXXX"
# Requisição no ambiente live
curl https://api.pagozz.com/v1/links \
-H "Pagozz-Token: pgz_live_XXXXXXXXXXXXXXXXXXXXXXXX"
Painel
No painel, um toggle permite alternar entre test e live. A seleção é persistida via cookie.
Simulação em Test Mode
No ambiente test, você pode simular todo o ciclo de vida de pagamentos e saques sem depender de APIs externas:
| Fluxo | Simulação disponível |
|---|
| PIX | Confirmar, expirar, falhar |
| Cartão | Aprovar risk analysis (cartão terminando em 9999) |
| Saque | Confirmar, falhar |
| KYC | Aprovar, rejeitar |
Via API
# Simular pagamento confirmado
POST /api/v1/payments/:id/simulate/succeed
# Simular pagamento expirado
POST /api/v1/payments/:id/simulate/expire
# Simular saque confirmado
POST /api/v1/withdrawals/:id/simulate/succeed
Via Painel
Na página de detalhes da transação, botões de simulação aparecem automaticamente quando environment = test e a transação está em status processing.
Simulações só funcionam no ambiente test. Tentativas em live retornam 403 Forbidden.
Checklist para ir para produção
Teste o fluxo completo
Crie links, processe pagamentos e receba webhooks em test mode.
Configure webhooks de produção
Crie endpoints com sua URL de produção no ambiente live.
Gere chave live
Crie uma API key pgz_live_* em Configurações → Chaves de API.
Atualize sua integração
Substitua a chave test pela chave live no seu servidor.
