PulsePag - Erros e retries

Erros e retries

Padronize o tratamento de falhas para evitar duplicidade, conciliação incorreta e reenvios indevidos.

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).
429	Rate limit / operação em andamento	Aplicar retry com backoff e evitar rajadas concorrentes.
500	Erro interno	Aplicar retry com backoff e logar correlação.

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.

Validar assinatura quando o webhook vier com headers da PulsePag.