Simular pagamentos

No sandbox nenhum dinheiro se move. O resultado de um pagamento é decidido pelo CPF (Pix) ou pelo número do cartão que você usar no checkout. Assim você testa o caminho feliz e cada falha sem depender de ninguém.

Como funcionaCopy Anchor Link

1. 1
   Crie um link
   POST /links no sandbox. Guarde a url devolvida.
2. 2
   Pague com um dado de teste
   Abra a url e use um CPF ou cartão desta página.
3. 3
   Receba os webhooks
   event.created na hora, o evento final entre 3 e 5 segundos depois.

Antes, cadastre um webhook assinando os tópicos que quer ver (veja o Começo rápido). Um endpoint do webhook.site é suficiente para testar.

PixCopy Anchor Link

Gere o QR Code no checkout informando um destes CPFs como documento do pagador. Não é preciso pagar o QR Code: o sandbox simula o resultado sozinho.

Cartão de créditoCopy Anchor Link

Use um destes números no checkout. Validade: qualquer data futura. CVV: quaisquer 3 dígitos. Nome: qualquer um.

Clique em um valor para copiar. CPFs e cartões são copiados só com os dígitos.

O que você deve receberCopy Anchor Link

Todo pagamento iniciado emite event.created assim que o pagador confirma no checkout. Depois chega um, e só um, evento final:

{
  "topic": "event.completed",
  "data": {
    "external_id": "0d4ba8f5-bbc6-4cbb-ae65-13de2f903271",
    "amount": "100",
    "currency": "BRL",
    "status": "done",
    "method": "pix",
    "payer": { "name": "John Doe", "email": "john@example.com", "document": "***.000.001-**" },
    "link": { "external_id": "b3e1c2d4-5f67-4890-9abc-1234567890ab", "external_ref": "pedido-123" }
  }
}

Checklist antes de ir para produçãoCopy Anchor Link

• Seu endpoint responde 2xx em menos de 30 segundos.
• Você valida o X-Signature e rejeita assinaturas inválidas.
• Receber o mesmo evento duas vezes não libera o pedido duas vezes.
• Os quatro cenários acima levam o pedido ao estado certo no seu sistema.
• Um link de uso único (single_use: true) recusa um segundo pagamento.
• Você trocou as credenciais e a URL base para as de produção.