DocsReferênciaCódigos de Estado HTTP
Protocolo HTTP

Códigos de Estado HTTP

A API utiliza códigos padrão do protocolo HTTP para indicar o desfecho de cada operação.

Códigos de Sucesso (2xx)

CódigoSignificado na EDPay
200 OKConsulta ou operação concluída com sucesso.
201 CreatedRecurso criado (cliente, link de pagamento, fatura).
202 AcceptedIntenção de pagamento aceite e em fila de processamento USSD.

Códigos de Erro (4xx e 5xx)

CódigoSignificado e Ação
400 Bad RequestPedido malformatado ou sintaxe JSON inválida.
401 UnauthorizedChaves de autenticação em falta, inválidas ou expiradas.
403 ForbiddenA conta não possui permissões para executar esta acção.
404 Not FoundO recurso especificado não existe no ambiente selecionado.
409 ConflictConflito de estado ou colisão de Idempotency-Key.
422 UnprocessableFalha de validação de negócio (ex.: saldo ou limites).
429 Too Many RequestsLimite de taxa atingido. Respeite o cabeçalho Retry-After.
500 Internal ErrorErro interno do servidor. Forneça o X-Request-Id ao suporte.
503 UnavailableServiço temporariamente em manutenção ou indisponível.