> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral de pagamentos

> Entenda como clientes, transações, Pix, vouchers, cartão, webhooks e reembolsos se conectam na Pagou v2.

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](/pt/payments/vouchers/accept-payments) para meios locais de caixa, transferência bancária, boleto e redirecionamento em países suportados.
* Use [Payment Element](/pt/payments/cards/payment-element) em novos checkouts com cartão.
* Mantenha um mapa canônico de status em [Status de transação](/pt/payments/transaction-statuses).
* 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

* [Clientes](/pt/payments/customers)
* [Receber pagamentos Pix](/pt/payments/pix/accept-payments)
* [Receber pagamentos por voucher](/pt/payments/vouchers/accept-payments)
* [Visão geral de cartão](/pt/payments/cards/overview)

## Exemplos executáveis

Veja código pronto e testável para este fluxo em [Exemplos de Pagamentos](/pt/examples/payments) — executável em sete linguagens no sandbox.