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ódigo | Significado na EDPay |
|---|---|
| 200 OK | Consulta ou operação concluída com sucesso. |
| 201 Created | Recurso criado (cliente, link de pagamento, fatura). |
| 202 Accepted | Intenção de pagamento aceite e em fila de processamento USSD. |
Códigos de Erro (4xx e 5xx)
| Código | Significado e Ação |
|---|---|
| 400 Bad Request | Pedido malformatado ou sintaxe JSON inválida. |
| 401 Unauthorized | Chaves de autenticação em falta, inválidas ou expiradas. |
| 403 Forbidden | A conta não possui permissões para executar esta acção. |
| 404 Not Found | O recurso especificado não existe no ambiente selecionado. |
| 409 Conflict | Conflito de estado ou colisão de Idempotency-Key. |
| 422 Unprocessable | Falha de validação de negócio (ex.: saldo ou limites). |
| 429 Too Many Requests | Limite de taxa atingido. Respeite o cabeçalho Retry-After. |
| 500 Internal Error | Erro interno do servidor. Forneça o X-Request-Id ao suporte. |
| 503 Unavailable | Serviço temporariamente em manutenção ou indisponível. |