Referência
Erros
Os erros têm sempre o mesmo formato e um código estável para você tratar no seu sistema.
JSON
{
"error": {
"code": "insufficient_credits",
"message": "O saldo de créditos atingiu o limite negativo. Recarregue para criar novas cobranças."
}
}Trate pelo code, não pela message: a mensagem é feita para gente ler e pode mudar. details é opcional.
| HTTP | code | Quando acontece |
|---|---|---|
| 400 | validation_error | Campos inválidos. details lista cada problema. |
| 400 | invalid_idempotency_key | A Idempotency-Key está vazia ou passa de 255 caracteres. |
| 400 | bad_request | Requisição malformada (JSON inválido, cursor inválido…). |
| 401 | invalid_api_key | API key ausente, inválida ou revogada. |
| 402 | insufficient_credits | Saldo no limite negativo. Recarregue para criar novas cobranças. |
| 403 | account_blocked | Conta bloqueada. Fale com o suporte. |
| 404 | charge_not_found | A cobrança não existe nesta conta. |
| 404 | terminal_not_found | O terminal não existe nesta conta. |
| 409 | terminal_revoked | O terminal foi revogado. |
| 409 | idempotency_conflict | A Idempotency-Key já foi usada com outros dados. |
| 409 | charge_not_cancelable | A cobrança já saiu da fila e não pode ser cancelada pela API. |
| 429 | rate_limited | Muitas requisições. Espere e tente de novo. |
| 500 | internal_error | Erro nosso. É seguro repetir com a mesma Idempotency-Key. |
O que repetir
- Pode repetir: erros de rede, timeouts,
429e5xx. Use a mesmaIdempotency-Key. - Não adianta repetir:
4xxdiferente de429. Corrija a requisição ou a situação da conta antes.