Central de Ajuda

API | Códigos de status da API (HTTP Status Code)

Recebeu algum erro ao enviar uma requisição para o Pagar.me?

Não se preocupe! Nós utilizamos os códigos de status HTTP para indicar o sucesso ou a falha de uma requisição.

Se sua requisição falhar, o Pagar.me retorna um erro usando o código apropriado.

Alguns exemplos de HTTP Status Code:

200 - A requisição foi bem sucedida e a solicitação foi atendida pela API. Para saber se a transação foi ou não autorizada pela adquirente, basta olhar o status da cobrança (paid ou failed). Exemplo: Enviar um pedido com pagamento em cartão e a API retornar que o mesmo tem saldo insuficiente

400 - Essa resposta significa que a API não entendeu a requisição pois está com uma sintaxe inválida. Exemplo: Enviar uma requisição em uma linguagem diferente de JSON.

401 - Houve uma falha na autenticação do cliente.  Exemplo: Enviar chave secreta errada.

404 - A API não pode encontrar o recurso solicitado. Exemplo: Listar um customer que não existe em sua loja.

412 - A solicitação não atende às regras de negócios da API. Exemplo: Tentar cancelar uma cobrança falha (não autorizada).

422 - Código que indica algum erro de validação. Exemplo: Tentar criar um customer sem nome (parâmetro obrigatório).

500 - A API encontrou uma situação com a qual não sabe lidar. Exemplo: Intermitência na aplicação.

Saiba mais sobre os erros mais comuns e como corrigir na nossa documentação.

Esse artigo foi útil?