Visão geral de pagamentos - Pagou Developer Docs

Use esta seção para escolher o caminho certo de pagamento antes de implementar os detalhes de endpoint.

Blocos principais

Capacidade	Superfície principal	Use para
Clientes	`/v2/customers`	perfis reutilizáveis de comprador
Transações	`/v2/transactions`	criação e consulta de pagamentos Pix, voucher e cartão
Reembolsos	`/v2/transactions/{id}/refund`	reversões totais e parciais
Webhooks	entrega de eventos de pagamento	mudanças assíncronas de status com autoridade

Escolhas recomendadas

Use Pix quando quiser o caminho mais rápido de cobrança no Brasil.
Use pagamentos por voucher para meios locais de caixa, transferência bancária, boleto e redirecionamento em países suportados.
Use Payment Element em novos checkouts com cartão.
Mantenha um mapa canônico de status em Status de transação.
Reconcilie em vez de adivinhar após falha de rede ou de worker.

Jornadas comuns

Crie um pagamento Pix, mostre os dados do QR code e libere o pedido em transaction.paid.
Crie um pagamento por voucher, mostre as instruções retornadas e reconcilie quando o cliente pagar pelo meio local escolhido.
Crie um pagamento com cartão a partir de um token do Payment Element e trate next_action quando houver 3DS.
Solicite reembolsos pelo seu back-end e espere o status resultante da transação se estabilizar.

Leia a seguir

Exemplos executáveis

Veja código pronto e testável para este fluxo em Exemplos de Pagamentos — executável em sete linguagens no sandbox.