Preloader
Desenvolvedor

Tratamentos de erros

Padronize o tratamento de falhas para evitar conciliação incorreta e duplicidade de operação.

Status HTTPSignificadoAção recomendada
200/201SucessoPersistir resposta e aguardar webhook quando aplicável.
400Erro de validaçãoCorrigir payload antes de reenviar.
401Não autenticadoValidar ci/cs ou Bearer token.
403Proibido/inativoVerificar status da conta/credencial.
404Não encontradoChecar IDs e ownership da transação.
409ConflitoNão repetir ação (ex.: defesa MED já enviada).
500Erro internoAplicar retry com backoff e logar correlação.
502/503Instabilidade externaRetry controlado e alerta operacional.
Boas práticas obrigatórias
  • Idempotência por transactionId/external_id.
  • Não atualizar saldo por polling apenas: priorize webhook.
  • Registrar request/response e timestamp para auditoria.
  • Implementar timeout e retry exponencial no cliente.