Modo de teste
Cenários do simulador para testar pagamento, falha e vencimento sem cobrar ninguém.
Uma chave ggpk_test_… nunca chama gateway e não cobra ninguém. O resultado é decidido pelos dados que você envia, e os webhooks são entregues de verdade, com livemode: false.
O PIX de teste tem um copia e cola falso, que não pode ser pago em nenhum banco.
Cenários
| Você envia | Acontece |
|---|---|
| buyer.document = 111.444.777-35 | PIX gerado, vence depois de 10 s |
| amount terminado em 51 (ex.: 4951) | PIX gerado, pago depois de 10 s |
| amount terminado em 52 | PIX gerado, falha depois de 10 s |
| amount terminado em 53 | PIX gerado, vence depois de 10 s |
| amount terminado em 55 | 402 pix_generation_failed, cobrança failed |
| qualquer outro valor | PIX gerado e nunca pago, vence em 2 h |
Os cenários são avaliados nessa ordem: o documento vem antes do valor. Cada cenário com prazo de 10 s dispara o webhook correspondente (payment_intent.succeeded, payment_intent.failed ou payment_intent.expired).
O que é igual à produção
- validação dos campos e códigos de erro;
- idempotência e
external_referenceúnica; - escopo de carteiras da chave;
- cancelamento;
- assinatura dos webhooks.
Cobranças de teste não aparecem em Vendas e não contam em ranking, Rewards ou Seasons.
Limites do modo de teste
O que muda são os limites de requisição. O modo de teste é gratuito e simulado, então os limites são menores e fixos, e não contam junto com os da produção:
| Operação | Por chave | Por conta (todas as chaves) |
|---|---|---|
| Criar cobrança | 10/min | 20/min |
| Consultar | 60/min | |
| Cancelar | 10/min | |
| Criar cobrança, por dia | 500 a cada 24 h |
Além disso, o modo de teste inteiro (todas as contas) divide um teto global de criações por minuto, para nunca competir com o tráfego de produção. Estourou qualquer um deles? 429 rate_limit_exceeded com o header Retry-After.