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_actionquando houver 3DS. - Solicite reembolsos pelo seu back-end e espere o status resultante da transação se estabilizar.