Ambiente de teste
Chaves sk_test_ falam com um ambiente à parte: cobranças, saldo, pagamentos, webhooks e logs próprios. Nada movimenta dinheiro, e as regras são as de produção: validações, escopos, Idempotency-Key e limites.
Como funciona
- O prefixo da chave escolhe o ambiente. Dado de teste nunca aparece com uma chave de produção, e o contrário também.
- O saldo de teste é separado e só cresce com cobranças de teste pagas (simuladas). Para testar um pagamento ou uma devolução, receba antes.
- Endpoints de webhook são cadastrados por ambiente; os de teste recebem os eventos de teste, com assinatura de verdade.
- O ambiente de teste funciona enquanto o cadastro da empresa está em análise.
Simular o pagador
O código PIX de uma cobrança de teste não é aceito por nenhum banco. Quem faz o papel do pagador são os simuladores, no checkout da cobrança de teste (o próprio checkoutUrl) e no painel, em Desenvolvedores › Ambiente de teste. Eles valem só para cobrança de teste ainda pendente. Não há rota da API para simular.
| Simulador | A cobrança fica | Webhook |
|---|---|---|
| Simular pagamento | PAID | charge.paid |
| Simular expiração | EXPIRED | charge.expired |
| Simular falha | FAILED | charge.failed |
O resultado passa pelo mesmo caminho de um aviso real do provedor: confirmação, extrato de teste e o evento para os seus endpoints.
Pagamentos e devoluções de teste
| Pedido | Resultado | Webhooks |
|---|---|---|
POST /v1/payouts | Aceito na hora e pago em alguns segundos. | payout.created e payout.paid |
Chave PIX com "falha" no texto (ex.: falha@exemplo.com) | Termina em falha; valor e tarifa voltam ao saldo de teste. | payout.failed |
POST /v1/charges/:id/refunds | Concluída em alguns segundos. | refund.created, refund.succeeded e charge.refunded ou charge.partially_refunded |
Devolução com "falha" no reason | Termina em falha; o valor volta ao saldo de teste. | refund.failed |
Não existe simulador de MED, nem no painel nem na API. O formato da disputa e dos eventos dela está em Como funciona a MED.
Acompanhar o que aconteceu
- Desenvolvedores › Ambiente de teste mostra as últimas cobranças de teste, os endpoints e o caminho requisição → evento → entrega.
- Desenvolvedores › Logs de requisições guarda cada chamada a /v1 por 30 dias, com o IP e o corpo; segredos somem e dados pessoais aparecem mascarados.
- Desenvolvedores › Webhooks mostra cada entrega, a resposta do seu servidor e o botão para reenviar.
Pronto para produção? Veja Depois do teste.