Possíveis códigos HTTP de status
| Código HTTP | Mensagem |
|---|---|
| 200 | Ok |
| 201 | Created |
| 202 | Accepted |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 405 | Method Not Allowed |
| 500 | Internal Server Error |
| 502 | Bad Gateway |
| 503 | Service Unavailable |
Para cada status teremos diferentes cenários, veja alguns exemplos de situações em que cada código pode retornar:
Respostas de sucesso
- 200 Ok: status informando que a solicitação foi atendida. Pode ser retornado ao obter um
AccessToken, por exemplo; - 201 Created: status informando que a criação da transação ocorreu corretamente (para todos os tipos de pagamentos: boleto, crédito, débito, transferência eletrônica e e-wallet).
Respostas de erro do Cliente
- 400 Bad Request: indica alguma falha na requisição (sintaxe JSON inválida);
- 401 Unauthorized: indica erro de autenticação. Pode ocorrer caso use o
MerchantKeyerrado, por exemplo; - 403 Forbidden: não autorizado por conta de restrição de IP na loja;
- 404 Not Found: o servidor não pode encontrar o recurso solicitado. O endpoint pode estar errado ou, no caso de consulta de pedidos, o pedido pode não existir, pode ter sido criado por outra loja (diferente da loja que você está usando) ou pode ter mais de três meses (período máximo para consultar pedidos na API);
- 405 Method Not Allowed: o método HTTP está incorreto (POST, PUT, GET, PATCH, DELETE).
Respostas de erro do Servidor
- 500 Internal Server Error, 502 Bad Gateway ou 503 Service Unavailable: podem ser retornados em alguma falha interna, como por exemplo indisponibilidade de algum meio de pagamento ou lentidão.Caso observe um desses retornos, recomendamos contatar o suporte para entender o real motivo.