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ódigoStatusDefinição
200OKSucesso
400Bad RequestRequisição inválida
401UnauthorizedChave de API inválida
403ForbiddenBloqueio por IP/Domínio
404Not FoundO recurso solicitado não existe
412Precondition FailedParâmetros válidos mas a requisição falhou
422Unprocessable EntityParâmetros inválidos
429Too Many RequestsQuantidade de requisições realizadas pelo IP maior que o permitido pela Pagar.me
500Internal Server ErrorOcorreu 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/RecursoMetodoRate Limit por minuto
/chargesGET200
/charges/*GET200
/charges/{{charge_id}}DELETESomente para PIX: Após a 10° tentativa de cancelamento de uma mesma cobrança, permitimos somente uma nova tentativa a cada 15 minutos.
/ordersGET200
/orders/*GET200
/recipientsGET100
/recipients/*GET150
/subscriptionsGET200
/subscriptions/*GET200
/invoicesGET200
/invoices/*GET200
/customersGET200
/customers/*GET200
/hooksGET50
/hooks/*GET50