Erros e Rate Limit

HTTP Status Codes


A nossa API valida cada um dos campos enviados na requisição antes de prosseguir com a criação, consulta ou gerenciamento dos pedidos, transações e recursos.

Utilizamos os códigos de resposta convencionais do HTTP para indicar o sucesso ou a falha de uma requisição. Sendo assim, códigos 2xx indicam sucesso, 4xx indicam erros por algum dado informado incorretamente (por exemplo, algum campo obrigatório não enviado ou um cartão sem data de validade) e 5xx indicando erros nos servidores do Pagar.me.

Tabela dos HTTP Status Code:

Código

Status

Definição

200

OK

Sucesso

400

Bad Request

Requisição inválida

401

Unauthorized

Chave de API inválida

403

Forbidden

Bloqueio por IP/Domínio

404

Not Found

O recurso solicitado não existe

412

Precondition Failed

Parâmetros válidos mas a requisição falhou

422

Unprocessable Entity

Parâmetros inválidos

429

Too Many Requests

Quantidade de requisições realizadas pelo IP maior que o permitido pela Pagar.me

500

Internal Server Error

Ocorreu um erro interno

{
  "message": "Customer not found."
}
{
  "message": "The request is invalid.",
  "errors": {
    "customer.name": [
      "The name field is required."
    ]
  },
  "request": {
    "name": null,
    "email": "[email protected]",
  }
}

Rate Limit - Tabela de quantidade máxima de requisições por minuto em cada endpoint:

Endpoint/Recurso

Metodo

Rate Limit por minuto

/charges

GET

200

/charges/*

GET

200

/orders

GET

200

/orders/*

GET

200

/recipients

GET

100

/recipients/*

GET

150

/subscriptions

GET

200

/subscriptions/*

GET

200

/invoices

GET

200

/invoices/*

GET

200

/customers

GET

200

/customers/*

GET

200

/hooks

GET

50

/hooks/*

GET

50