Boas práticas
Boas práticas
Padrões que economizam dor de cabeça em produção. Cada tópico vira uma página própria com Mermaid, exemplos em curl/Node/Python/Go/PHP e tabela de armadilhas.
Por onde começar
| Se você é | Comece por |
|---|---|
| Primeira integração | Idempotência → Callbacks |
| Plataforma multi-loja / marketplace | Multi-tenant |
| Migrando de outro PSP | Dinheiro (reais vs centavos) |
| Já em prod, refinando | Tratamento de erros → Checklist |
| Reunindo evidências pra auditoria/compliance | Segurança |
Visão geral
Webhooks
O sistema de webhooks da Saq 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.
Idempotência
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.