Sandbox
O sandbox existe para você validar a integração inteira sem movimentar valores reais. É nele que você confirma se:- o checkout é criado do jeito certo
- o Pix aparece como esperado
- os webhooks chegam
- sua conciliação funciona
Como identificar respostas de teste
Sempre que você usar uma chavetrq_test_, a resposta virá com:
livemode: false- dados marcados como teste
- webhooks com
livemode: false
O ambiente não muda pela URL. Ele muda pela chave que você usa na requisição.
O que vale a pena testar no sandbox
Criação do checkout
Confirme se seu backend cria a cobrança, salva
checkoutId e relaciona tudo com externalId.Exibição do Pix
Verifique se seu front-end mostra o
copyPaste, o QR Code ou o checkout hospedado sem depender do backend a cada refresh.Consulta e reconciliação
Teste
GET /v1/checkouts/{checkoutId} e GET /v1/checkouts para garantir visibilidade operacional.Estados que você vai ver com mais frequência
| Status | O que significa |
|---|---|
PENDING | Checkout criado e aguardando pagamento |
PAID | Pix confirmado |
EXPIRED | O prazo da cobrança terminou |
CANCELLED | Checkout cancelado |
Checklist antes de ir para produção
- o checkout é criado sem duplicidade
- o app consegue renderizar o Pix corretamente
- o sistema processa
checkout.paid - a reconciliação usa
checkoutIdouexternalId - seus logs e monitoramento diferenciam teste e produção