https://api.sandbox.pagou.ai).
O adquirente de teste do sandbox decide o resultado de cada cobrança a partir dos valores abaixo, para
que você valide sua integração de ponta a ponta — aprovações, recusas, 3DS e liquidação assíncrona de
Pix/Boleto — sem usar um provedor real.
Estes valores funcionam apenas em sandbox. Em produção, os adquirentes reais decidem o resultado.
Mantenha credenciais, webhooks e base URLs de sandbox e produção separados (veja
Ambientes).
Pix, Boleto e Voucher
Uma cobrança Pix/Boleto/Voucher é criada comowaiting_payment (com QR code ou código de barras). O
sandbox a liquida para paid 15 segundos após a geração do QR code / código de barras quando a
cobrança é elegível. A elegibilidade é decidida pelo documento do pagador ou — quando nenhum documento
é enviado — pelo valor:
| Para obter um pagamento aprovado | Envie |
|---|---|
| Por documento do comprador | buyer.document.number = 06957410600 ou 39027187819 (qualquer valor) |
| Sem documento aprovado | amount = 7300 (R$ 73,00) e currency = BRL |
pending e nunca liquida — use isto para
testar seu tratamento de pendência/expiração.
Mostre o QR code / código de barras
A resposta retorna um EMV Pix escaneável (copia e cola) ou um código de barras de Boleto em
waiting_payment.Cartão de crédito
Qualquer informação do pagador é aceita. O status final é decidido pelo número do cartão — use qualquer validade futura e qualquer CVV, salvo indicação abaixo.| Cenário | Bandeira | Número | Validade | CVV | Resultado |
|---|---|---|---|---|---|
| Aprovado (à vista) | Visa | 4548 8120 4940 0004 | 12/34 | 123 | captured |
| Aprovado (parcelado) | Mastercard | 5067 2300 0000 9011 | 01/28 | 123 | captured |
| Aprovado (parcelado) | Visa | 4761 1200 0000 0148 | 01/28 | 123 | captured |
| Recusado | Visa | 1111 1111 1111 1117 | 12/34 | 123 | refused (card_declined) |
| 3DS Challenge | Visa | 4918 0191 9988 3839 | 12/34 | 123 | three_ds_required → desafio |
| 3DS Frictionless | Visa | 4918 0191 6003 4602 | 12/34 | 123 | captured (sem desafio) |
| Tokenização | — | 5448 2800 0000 0007 | 01/35 | 123 | tokeniza; cobrança captured |
3DS Challenge
O cartão 3DS Challenge retornathree_ds_required com um next_action. Complete o desafio no
Payment Element (ou no endpoint de desafio do sandbox); em caso de sucesso a transação liquida para
paid, em caso de falha para refused. Veja
Three-D Secure para o fluxo no navegador.
3DS Frictionless
O cartão 3DS Frictionless autentica sem desafio e é aprovado diretamente — use-o para verificar o caminho feliz sem desafio.Verificando o resultado
Sempre confie no webhook, não na resposta síncrona, como fonte da verdade:- Pix/Boleto/Voucher →
payment.confirmed~15s após a criação (cobranças elegíveis). - Cartão aprovado →
captured; recusado →refused.