Boas práticas
O que separa uma integração que aguenta produção de uma que quebra na primeira semana: idempotência, callbacks, dinheiro em reais, segurança e os demais padrões que evitam cobrança duplicada e callback perdido quando o volume cresce.
Padrões que economizam dor de cabeça em produção. Aplicados juntos, evitam cobranças duplicadas, perda de callbacks e erros de arredondamento em reais quando o volume cresce.
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
Infrações (MED)
Quando um pagador aciona o Mecanismo Especial de Devolução por fraude ou erro, você é avisado na hora e tem um prazo curto pra defender a transação ou aceitar a devolução antes do Banco Central bater o martelo.
Idempotência
Chamar a mesma operação de novo não deveria cobrar duas vezes nem dar baixa em dobro: veja como usar a sua referência para amarrar isso e por que os callbacks chegam repetidos.