GG CheckoutCentral de Ajuda
API de pagamentos

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ê enviaAcontece
buyer.document = 111.444.777-35PIX gerado, vence depois de 10 s
amount terminado em 51 (ex.: 4951)PIX gerado, pago depois de 10 s
amount terminado em 52PIX gerado, falha depois de 10 s
amount terminado em 53PIX gerado, vence depois de 10 s
amount terminado em 55402 pix_generation_failed, cobrança failed
qualquer outro valorPIX 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çãoPor chavePor conta (todas as chaves)
Criar cobrança10/min20/min
Consultar60/min
Cancelar10/min
Criar cobrança, por dia500 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.

Nesta página