https://api.sandbox.pagou.ai).
Os valores abaixo permitem validar aprovações, recusas, 3DS e liquidação assíncrona de Pix/Boleto de
ponta a ponta sem movimentar dinheiro real.
Estes valores funcionam apenas em sandbox. Em produção, o resultado depende da tentativa real de
pagamento. 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:
Qualquer outro valor (sem um documento aprovado) permanece
pending e nunca liquida — use isto para
testar seu tratamento de pendência/expiração.
1
Crie a cobrança
Envie uma cobrança Pix, Boleto ou Voucher com uma das combinações elegíveis acima.
2
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.3
Aguarde ~15 segundos
O sandbox confirma cobranças elegíveis e dispara o webhook
payment.confirmed; a transação vai
para paid.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.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.

