Erros

Códigos de status, códigos de erro e o que fazer em cada caso.

Todos os erros têm o mesmo formato:

{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_error",
    "message": "`kg` is invalid: Too small: expected number to be >=1.",
    "param": "kg"
  }
}

param indica o campo da requisição que causou o erro, quando houver um. Toda resposta tem um cabeçalho Request-Id. Informe esse valor ao entrar em contato com o suporte.

Status	Código	Tentar de novo?	O que fazer
400	`invalid_json`	Não	Envie um objeto JSON de no máximo 10 KB.
400	`idempotency_key_missing` / `idempotency_key_invalid`	Não	Envie uma Idempotency-Key válida.
401	`invalid_api_key`	Não	Verifique a chave. Ela pode ter sido revogada.
402	`insufficient_balance`	Após uma recarga	O erro inclui `balance_cents` e `required_cents`.
403	`api_access_inactive`	Não	A conta não foi aprovada ou está suspensa. Entre em contato com o suporte.
403	`insufficient_permissions`	Não	Use uma chave com acesso de compra.
404	`resource_missing` / `not_found`	Não	Verifique o ID da compensação ou o caminho.
409	`idempotency_key_reused`	Não	Use uma nova chave para cada nova compra.
422	`validation_error`	Não	Corrija o campo indicado em `param`.
422	`amount_too_small`	Não	Com a sua tarifa, o valor compra menos de 1 kg.
429	`rate_limited`	Sim	Aguarde o número de segundos indicado em `Retry-After`.
500	`api_error`	Sim	Tente de novo com a mesma Idempotency-Key.