Best practices
Best practices
Patterns that save headaches in production. Each topic becomes its own page with Mermaid, examples in curl/Node/Python/Go/PHP, and a pitfalls table.
Where to start
| If you are | Start with |
|---|---|
| First integration | Idempotency → Callbacks |
| Multi-store platform / marketplace | Multi-tenant |
| Migrating from another PSP | Money (reais vs cents) |
| Already in prod, refining | Error handling → Checklist |
| Gathering evidence for audit/compliance | Security |
Overview
Webhooks
O sistema de webhooks da Pix Processamento envia notificações em tempo real sobre mudanças de status de transações. Ao criar uma transação e fornecer um callbackUrl, atualizamos automaticamente sua aplicação a cada mudança. Inclui retry com backoff exponencial de até 72 tentativas.
Idempotency
clientReference é a sua chave de idempotência e callbacks chegam mais de uma vez. Como combinar os dois para que retries não viram cobranças duplicadas nem baixas em dobro.