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.

Simuladores de cobrança
SimuladorA cobrança ficaWebhook
Simular pagamentoPAIDcharge.paid
Simular expiraçãoEXPIREDcharge.expired
Simular falhaFAILEDcharge.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

Pagamentos e devoluções de teste
PedidoResultadoWebhooks
POST /v1/payoutsAceito 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/refundsConcluída em alguns segundos.refund.created, refund.succeeded e charge.refunded ou charge.partially_refunded
Devolução com "falha" no reasonTermina 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.