Skip to main content
A API retorna erros em um formato consistente em JSON:
{
  "success": false,
  "message": "Mensagem descritiva do erro."
}
Erros de validação podem incluir um campo adicional errors/details com a lista de problemas.

Códigos de status

CódigoSignificadoQuando acontece
400Bad RequestCorpo inválido, validação de schema, documento inválido, saldo insuficiente.
401UnauthorizedCredenciais inválidas, token ausente, inválido ou expirado.
403ForbiddenSem permissão para o recurso.
404Not FoundRecurso (ex.: transferência) não encontrado.
409ConflictConflito de estado do recurso.
429Too Many RequestsLimite de requisições excedido.
503Service UnavailableServiço temporariamente indisponível.

Dicas

O token tem expiração curta (veja expiresIn, em milissegundos). Gere um novo token e tente novamente.
A soma de amountInCents × quantity dos itens precisa ser exatamente igual a amountInCents.
O customer.document precisa ser um CPF/CNPJ válido, de acordo com o documentType informado.