Blocos principais
| Capacidade | Superfície principal | Use para |
|---|---|---|
| Customers | /v2/customers | perfis reutilizáveis de comprador |
| Transactions | /v2/transactions | criação e consulta de pagamentos Pix e cartão |
| Refunds | /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 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 faça fulfillment em
transaction.paid. - 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.