Padronize o tratamento de falhas para evitar conciliação incorreta e duplicidade de operação.
| Status HTTP | Significado | Ação recomendada |
|---|---|---|
| 200/201 | Sucesso | Persistir resposta e aguardar webhook quando aplicável. |
| 400 | Erro de validação | Corrigir payload antes de reenviar. |
| 401 | Não autenticado | Validar ci/cs ou Bearer token. |
| 403 | Proibido/inativo | Verificar status da conta/credencial. |
| 404 | Não encontrado | Checar IDs e ownership da transação. |
| 409 | Conflito | Não repetir ação (ex.: defesa MED já enviada). |
| 500 | Erro interno | Aplicar retry com backoff e logar correlação. |
| 502/503 | Instabilidade externa | Retry controlado e alerta operacional. |