Códigos HTTP

HTTP Status CodeDescrição
200OK (captura, cancelamento e consulta)
201OK (autorização da transação)
400Bad Request
401Unauthorized
403Forbidden
404Resource Not Found
405Method Not Allowed
500Internal Server Error
502Bad Gateway
503Service Unavailable

Para cada status teremos diferentes cenários, veja alguns exemplos de situações em que cada código pode retornar:

Respostas de sucesso

Retorno HTTPCenário de exemplo
200 OkInforma que a solicitação foi atendida. Pode ser retornado ao obter um AccessToken, por exemplo
201 Createdstatus 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

Retorno HTTPCenário de exemplo
400 Bad RequestIndica alguma falha na requisição (sintaxe JSON inválida).
401 Unauthorizedindica erro de autenticação. Pode ocorrer caso use o MerchantKey errado, por exemplo;
403 Forbiddennão autorizado por conta de restrição de IP na loja;
404 Not Foundo 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 Allowedo método HTTP está incorreto (POST, PUT, GET, PATCH, DELETE).

Respostas de erro do servidor

Retorno HTTPCenário de exemplo
500 Internal Server Error, 502 Bad Gateway ou 503 Service UnavailablePodem ser retornados em alguma falha interna na Braspag, 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