Boas práticas
Padrões para operar pagamentos de forma segura, resiliente e auditável.
Rede e retentativas
Use timeouts, retentativa exponencial somente para erros transitórios e a mesma idempotência em todas as tentativas da mesma operação.
Webhooks confiáveis
Valide HMAC antes do JSON, rejeite assinatura inválida, deduplique pelo ID e processe fora do request.
Observabilidade
Correlacione referência, ID LeonaPay, idempotency-key e RequestId. Nunca registre chaves, segredos, PAN, CVV ou documentos completos.
| Métrica | Alerta |
|---|---|
Erros 5xx | Acima da linha de base |
Latência p95 | Acima do timeout |
Webhook pendente | Fila crescendo |
Conciliação divergente | Qualquer divergência |