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 |
/charges/{{charge_id}} | DELETE | Somente para PIX: Após a 10° tentativa de cancelamento de uma mesma cobrança, permitimos somente uma nova tentativa a cada 15 minutos. |
/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 |