Skip to main content
Use esta página para obter resultados determinísticos em sandbox (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 como waiting_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 retorna three_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.
Veja Webhooks e Status de transação para o ciclo de vida completo.

Próximos passos