Pular para o conteúdo principal
Com uma chave de teste (Sandbox), tudo funciona como em produção, mas nenhum dinheiro real se move. Os pagamentos de teste aparecem com livemode: false e os webhooks são entregues de verdade para a sua URL.

Roteiro

1

Webhook recebido e assinatura válida

Cadastre o endpoint, crie uma cobrança e confira em Desenvolvedores → Webhooks se a entrega ficou como entregue. Teste também uma assinatura errada: o seu servidor deve recusar.
2

Pix

Crie um Pix com POST /v1/payments e confira que o QR Code e o copia e cola aparecem para o cliente. Deixe um Pix expirar (use expires_in: 60) e confira o evento payment.expired.
3

Checkout

Crie uma compra com POST /v1/checkouts, abra o checkout_url e percorra cada forma de pagamento aceita.
4

Cartão

No checkout de teste, use um cartão de teste (abaixo) e confira payment.succeeded. Depois, provoque uma recusa e confira payment.failed.
5

Eventos repetidos

Reenvie uma entrega pelo painel e confira que o seu sistema não libera o pedido duas vezes.
6

Erros

Envie um corpo inválido e confira que o seu sistema mostra a mensagem certa (422 invalid_request).

Cartões de teste

Use qualquer nome, validade futura, CVV de 3 dígitos e um CPF válido.
Nunca use um cartão real no ambiente de teste.

Depois dos testes

Quando o roteiro passar, siga o checklist de produção.