Erros (em construção... 🚧)

Estes são os principais erros e suas descrições que cada endpoint retorna.

Obter ajuda

Não encontrou o erro que estava procurando? Entre em contato com o Suporte.


Faturas

POST v1/invoices

400

ErroDescrição
due_date: é obrigatórioO parâmetro due_date é obrigatório.

422

ErroDescrição
email: não pode ficar em brancoQuando customer_id é null, o parâmetro email é obrigatório.
cc_emails: is invalidO formato do e-mail inserido no parâmetro cc_emails é inválido
bank_slip_extra_due: o prazo máximo para pagamento deve ser entre 1 e 30 dias após a data de vencimentoO parâmetro bank_slip_extra_due recebe valores de 1 a 30.
expires_in: Expires_in inválido, deve ser entre 1 e 30 diasO parâmetro expires_in recebe valores de 1 a 30.
due_date: não pode ficar em brancoO parâmetro due_date é obrigatório e não pode ficar em branco.
due_date: não pode estar mais que quatro anos a frenteO parâmetro due_date recebe valores até 4 anos da data atual.
due_date: não pode estar no passadoO parâmetro due_date não recebe valores considerados passado da data atual.
total: deve ser maior que 1O parâmetro quantity do objeto items não pode ser vazio (null).
items: items.price_cents: não pode ficar em brancoO parâmetro price_cents do objeto items não pode ser vazio (null).
items:items.quantity: não é um númeroO parâmetro quantity do objeto items recebe apenas números (int32).
items: items.description: não pode ficar em brancoO parâmetro description do objeto items é obrigatório.
payer: payer.cpf_cnpj: não pode ficar em brancoPara o método de pagamento bank_slip, o parâmetro cpf_cnpj e name do objeto payer são obrigatórios.
payer: payer.name: não pode ficar em brancoPara o método de pagamento bank_slip, o parâmetro cpf_cnpj e name do objeto payer são obrigatórios.
return_url: não é uma url válidaO URL inserido no parâmetro return_url não é válido.
expired_url: não é uma url válidaO URL inserido no parâmetro expired_url não é válido.
notification_url: não é uma url válidaO URL inserido no parâmetro notification_url não é válido.
invalid_fines: Multa não pode ser valor negativoO parâmetro late_payment_fine recebe apenas valores positivos.
late_payment_fine_cents: invalid_fines: Multa não pode ser valor negativoO parâmetro late_payment_fine_cents recebe apenas valores positivos.
customer: não é válidoO valor inserido no parâmetro customer_id inserido é inválido
subscription_id: is invalidO valor inserido no parâmetro subscription_id é inválido
payable_with: não é válidoO valor inserido no parâmetro payable_with é inválido.
max_installments_value: deve ser menor que ou igual aO parâmetro max_installments_value recebe um valor menor ou igual a propriedade credit_card > max_installments do endpoint Configurar Conta e/ou Informações da Conta.
splits: base: Split deve ter valor em centavos ou em percentual.Os parâmetros cents e/ou percent do objeto splits não foram preenchidos corretamente ou estão vazios.
splits: base: Conta do destinatário inválida.O ID da conta informado no parâmetro recipient_account_id está incorreto.
splits: base: Conta do destinatário não pode ser a conta atual.O account_id do api_token utilizado na requisição é o mesmo inserido no parâmetro recipient_account_id do objeto splits.
splits: base: Conta destinatário é inválidoO valor inserido no parâmetro recepient_acount_id do objeto splits é inválido.
base: Conta do destinatário com duplicidadeO valor informado no parâmetro receiver_account_id do objeto splits está duplicado.
soft_descriptor_light: é muito longo (máximo: 12 caracteres).O parâmetro soft_descriptor_light tem limite de 12 caracteres.
base: Valor da fatura excede o limite de cobrança configurado em sua conta para transações por cartão de crédito.Valor limite para transações com credit_card excedido. Entre em contato com o Suporte.
items: Total máximo de items excedido (30).O número de itens do objeto items excedeu o limite de 30.
items: items.price_cents: Não é um número inteiro.O parâmetro price_cents do objeto recebe apenas números inteiros (int32).
items: quantity: não é um número inteiroO parâmetro quantity do objeto items recebe apenas números inteiros (int32)
invoice: invoice.limit: Limite de criação de faturas atingido.?
splits: Conta do destinatário deve estar no mesmo contextoO account_id inserido no parâmetro receiver_account_id não faz parte arranjo de contas. Saiba mais.
early_payment_discounts: não pode ser maior que ou igual ao total da faturaO valor inserido no parâmetro early_payment_discounts recebe apenas valores menores ao valor total da fatura.
fines: Somente um campo de multa pode ser informadoÉ possível utilizar um parâmetro fines: late_payment_fine (%) ou late_payment_fine_cents.

POST v1/{id}/capture

400

ErroDescrição
Apenas Faturas em análise podem ser capturadasApenas invoice_id com status in_analisys podem utilizadas nesta requisição. Saiba mais .

422

ErroDescrição
Invoice Not FoundO valor informado no parâmetro id não foi encontrado ou não existe.

POST v1/{id}/refund

400

ErroDescrição
Apenas Faturas pagas podem ser reembolsada.O status do invoice_id informado no parâmetro id é diferente de paid.
Valor maior que o permitido para reembolso.O valor informado no parâmetro partial_value_refund_cents é maior que o valor total da fatura.

404

ErroDescrição
Invoice Not FoundO valor informado no parâmetro id não foi encontrado ou não existe.

PUT v1/{id}/cancel

400

ErroDescrição
Apenas faturas em análise ou pendentes podem ser canceladasO status do invoice_id informado no parâmetro id é diferente de in_analisys ou pending.

404

ErroDescrição
Invoice Not FoundO valor informado no parâmetro id não foi encontrado ou não existe.

POST v1/{id}/duplicate

400

ErroDescrição
Apenas Faturas pendentes podem ter segunda via gerada.O status do invoice_id informado no parâmetro id é diferente de pending.
Faturas expiradas originadas em Carnês ou Assinaturas não podem ser duplicadas.Não é possível gerar 2ª via de Faturas geradas por subscriptions e/ou carnês.

422

ErroDescrição
não pode estar no passado.O parâmetro due_date não recebe valores considerados passado da data atual.
cc_emails: is invalid.O formato do e-mail inserido no parâmetro cc_emails é inválido
due_date: não pode estar mais que quatro anos a frente.O parâmetro due_date recebe valores até 4 anos da data atual.
items: items.price_cents: Não é um número.O parâmetro price_cents do objeto recebe apenas números (int32).
items: items.price_cents: Não é um número inteiro.O parâmetro price_cents do objeto recebe apenas números inteiros (int32).
Faturas pendentes não podem alterar forma de pagamento.O valor informado no parâmetro payable_with é diferente da 1ª via da Fatura.
Faturas pendentes necessitam de pelo menos um item.O valor informado no parâmetro quantity e/ou price_cents do objeto items é menor ou igual a 3.
due_date: não pode ficar em brancoO parâmetro due_date é obrigatório e não pode ficar em branco.

POST v1/{id}/duplicate

400

ErroDescrição
Apenas Faturas expiradas podem ser reemitidas.O status do invoice_id informado no parâmetro id é diferente de expired.
Faturas expiradas originadas em Carnês ou Assinaturas não podem ser duplicadas.Não é possível gerar 2ª via de Faturas geradas por subscriptions e/ou carnês.

422

ErroDescrição
due_date: não pode estar no passado.O parâmetro due_date não recebe valores considerados passado da data atual.
cc_emails: is invalid.O formato do e-mail inserido no parâmetro cc_emails é inválido.

Tokens e Cobrança Direta

POST v1/payment_token

400

ErroDescrição
account_id: está invalidoO account_id informado é inválido.
api_token: está invalidoO api_token informado é inválido.

422

ErroDescrição
number: is not a valid credit card numberO número do cartão de crédito inserido no parâmetro number do objeto data não é válido.
year: expiredO Ano de Vencimento do cartão de crédito inserido no parâmetro year do objeto data está expirado.

POST v1/charge

400

ErroDescrição
credit_card: token não é válido.
  • O token inserido no parâmetro token não é válido.
  • O token inserido no parâmetro token foi gerado em ambiente de test e o api_token utilizado nesta requisição é live (produção) ou vice e versa.
  • bank_slip: method: credit_cards não é suportado. (Métodos suportados: bank_slip).O parâmetro method recebe apenas bank_slip.

    422

    ErroDescrição
    total: deve ser maior que 1.Se parâmetro invoice_id vazio (null), o parâmetro price_cents deve ser maior que 100 ou parâmetro quantity maior que 1.
    payer.cpf_cnpj: não pode ficar em branco.Se parâmetro invoice_id e/ou customer_id vazio (null), o parâmetro deve ser informado com o CPF ou CNPJ do pagador.
    payer.name: não pode ficar em branco.Se parâmetro invoice_id e/ou customer_id vazio (null), o parâmetro name deve ser informado com o nome do pagador.
    payer.address.zip_code: não pode ficar em branco.Se parâmetro invoice_id e/ou customer_id vazio (null), o parâmetro zip_code deve ser informado com o CEP do pagador.
    payer.address.zip_code: não é válido.O valor informado no parâmetro zip_code do objeto address não é válido.

    Carnês

    POST v1/payment_booklets

    404

    ErroDescrição
    customer: Cliente não encontrado.O valor informado no parâmetro customer_id não foi encontrado.

    400

    ErroDescrição
    installments: Não pode estar em branco.O parâmetro installments é obrigatório.
    installments: Valor total da fatura não pode ser menor que R$1,00.O valor de cada parcela (fatura) do carnê, deve ser, no mínimo, 100 cents.
    description: não pode ficar em branco.O parâmetro description é obrigatório.
    started_at: não pode estar no passado.O parâmetro started_at não aceita datas no passado.
    Você deve usar porcentagem OU valor em centavosEnquanto early_payment_discounts for true, deve-se utilizar percent ou value_cents do objeto early_payment_discounts.

    PUT v1/{id}/cancel

    400

    ErroDescrição
    Carnê não pode ser cancelado.É possível cancelar apenas carnês com status pending.

    404

    ErroDescrição
    Payment booklet Not FoundO valor informado no parâmetro id não encontrou nenhum carnê.

    Clientes

    POST v1/customers

    422

    ErroDescrição
    email: não pode ficar em branco.O parâmetro email é obrigatório.
    email: is invalid.O valor informado no parâmetro email é inválido.
    phone: não é válido.O valor informado no parâmetro phone é inválido.
    phone_prefix: não é válido.O valor informado no parâmetro phone_prefix é inválido ou está vazio.
    cpf_cnpj: is invalid.O valor informado no parâmetro cpf_cnpj é inválido.
    district: não pode ficar em branco.Enquanto zip_code for informado e incompleto, o parâmetro district se torna obrigatório.
    number: não pode ficar em branco.Enquanto zip_code for informado, o parâmetro number torna-se obrigatório.
    street: não pode ficar em branco.Enquanto zip_code for informado e incompleto, o parâmetro street se torna obrigatório.

    POST v1/{customer_id}/payment_methods

    422

    ErroDescrição
    data: não pode ficar em branco.O parâmetro token é obrigatório.
    description: não pode ficar em branco.O parâmetro description é obrigatório.
    item_type: não pode ficar em branco.O parâmetro token é obrigatório.
    item_type: não é suportado. (Métodos suportados: credit_card)O valor informado no parâmetro token é inválido e não é suportado.
    token: Esse token já foi usado.O valor informado no parâmetro token já foi utilizado. Os tokens são de utilização única. Saiba mais.

    Splits

    POST v1/splits

    422

    ErroDescrição
    Split deve ter valor em centavos ou em percentual.Enquanto o parâmetro permit_aggregated for null ou false, só é possível utilizar apenas cents ou percent.
    Conta do destinatário inválida.O valor informado no parâmetro recipient_account_id não existe ou é inválido.
    Recipient account não pode ficar em branco.O parâmetro recipient_account_id é obrigatório.
    Percent deve ser maior que ou igual a 0O parâmetro percent aceita apenas valores maior ou igual a 0.
    Cents deve ser maior que ou igual a 0O parâmetro cents aceita apenas valores maior ou igual a 0.
    Bank slip cents deve ser maior que ou igual a 0O parâmetro bank_slip_cents aceita apenas valores maior ou igual a 0.
    Bank slip percent deve ser maior que ou igual a 0O parâmetro bank_slip_percent aceita apenas valores maior ou igual a 0.
    Credit card cents deve ser maior que ou igual a 0O parâmetro credi_card_cents aceita apenas valores maior ou igual a 0.
    Credit card percent deve ser maior que ou igual a 0O parâmetro credi_card_percent aceita apenas valores maior ou igual a 0.
    Pix cents deve ser maior que ou igual a 0O parâmetro pix_cents aceita apenas valores maior ou igual a 0.
    Pix percent deve ser maior que ou igual a 0O parâmetro pix_percent aceita apenas valores maior ou igual a 0.

    Planos

    POST v1/plans

    422

    ErroDescrição
    name: não pode ficar em branco.O parâmetro name é obrigatório.
    identifier: não pode ficar em brancoO parâmetro identifier é obrigatório.
    interval: deve ser maior que 0.O parâmetro interval aceita apenas valores maior que 0.
    interval_type: não pode ficar em brancoO parâmetro interval_type é obrigatório.
    interval_type: is invalid.O valor informado no parâmetro interval_type é inválido ou está em branco.
    prices: não pode ficar em branco.O parâmetro value_cents é obrigatório.
    interval: não pode ficar em branco.O parâmetro interval é obrigatório.
    interval: não é um número.O parâmetro interval aceita apenas números (int32)
    features.value: não pode ficar em brancoSe qualquer parâmetro do objeto features for utilizado, todos se tornam obrigatórios (name, identifier e value).
    features.name: não pode ficar em branco.Se qualquer parâmetro do objeto features for utilizado, todos se tornam obrigatórios (name, identifier e value).
    features.value: não é um número.O valor informado no parâmetro value do objeto features não é um número (int32) ou está em branco.
    identifier: já está em uso.O valor informado no parâmetro identifier já está sendo utilizado em outro plano.
    invoice_max_installments: deve ser maior ou igual a 0.O parâmetro invoice_max_installments aceita apenas valores maior ou igual a 0.
    max_cycles: deve ser maior que ou igual a 0.O parâmetro max_cycles aceita apenas valores maior que 0.
    payable_with: não é válido.O valor informado no parâmetro payable_with aceita apenas os valores credit_card, bank_slip, pix e/ou all.

    Assinaturas

    v1/subscriptions

    400

    ErroDescrição
    Apenas uma criação de assinatura pode ser processada por vez. Por favor, tente novamente em breve.
    Para utilizar only_on_charge_success seu cliente deve ter um método de pagamento padrãoCertifique-se que o customer_id em questão tenha um customer_payment_method_id definido como default. Saiba mais .
    expires_at: não pode estar no passado.O parâmetro expires_at não aceitas datas passadas.

    422

    ErroDescrição
    payable_with: são incompatíveis com o plano. Métodos disponíveis no plano: [método(s)]O valor informado no parâmetro payable_with não é compatível com o valor informado na criação/configuração plano.
    plan_identifier: is invalidO valor informado no parâmetro plan_identifier é inválido ou não existe.
    price_cents: não pode ficar em branco.O parâmetro price_cents é obrigatório.
    price_cents: deve ser maior que 0.O parâmetro price_cents aceita apenas valores maior que 0.
    price_cents: não é um número.O valor informado no parâmetro price_cents não é um número (int32) ou está em branco.
    credits_cycle: não pode ficar em branco.O parâmetro credits_cycle é obrigatório.
    credits_cycle: não é um número.O valor informado no parâmetro credits_cycle não é um número (int32) ou está em branco.

    GET v1/subscriptions

    400

    ErroDescrição
    Limite para listagem excedido (max. 10000)O limite máximo para paginação é de 10.000 itens.

    Transferência de Valores

    POST v1/transfers

    🚧

    Assinatura RSA

    Este endpoint obriga informar a Assinatura RSA. Saiba mais.

    422

    ErroDescrição
    Public Key Not FoundSaiba mais.
    Invalid Elepsed TimeSaiba mais.
    Invalid SignatureSaiba mais.

    POST v1/accounts/{id}/request_withdraw

    422

    ErroDescrição
    amount: maior que o saldo da conta.O valor informado no parâmetro amount é maior que o saldo disponível para saque da conta (balance_available_for_withdraw) em questão.
    amount: máximo de 2 casas decimaisO parâmetro amount (float) aceita, no máximo, duas casas decimais — e.g. 10.00.
    amount: deve ser maior que ou igual a 5.O valor inserido no parâmetro amount é menor que 5. O valor mínimo para saques são de R$5,00.
    Essa conta não tem permissão para pedir transferências.O recurso de saque não está habilitado. Entre em contato com o Suporte.

    Convites

    POST v1/{account_id}/user_invites

    422

    ErroDescrição
    permissions: não é válido.O valor informado no parâmetro permissions é inválido. Opções disponíveis: owner, analytics, operations, financial, operations-read-only ou financial-read-only. Saiba mais.
    email: já está em uso.O e-mail informado no parâmetro email já é um usuário da conta em questão.

    Gatilhos

    v1/web_hooks

    422

    ErroDescrição
    account: não pode ter mais de 30 gatilhosSó é permitido 30 gatilhos account_id.
    url: não é uma url válida.A URL deve ser acompanhada de "https://..."
    event: is invalid.O valor informado no parâmetro event não é compatível. Consulte a lista de eventos.
    amount: limite de valor de saques excedidoLimite total de saques excedido. Saiba como aumentar limite operacional.

    Antecipação de recebíveis

    POST v1/advancement_request/simulation

    400

    ErroDescrição
    Antecipações são permitidas apenas em dias úteis, entre 09:05 e 18:50.A requisição foi feita fora do período permitido.
    Valor da antecipação 0 é inválido.O parâmetro requested_advancement_cents recebe valores acima de 1 ou está vazio.
    Sua conta possui uma simulação de antecipação em andamento.É possível criar apenas uma simulação por vez. Verificar Status da Simulação.

    GET v1/advancement_request/simulation

    400

    ErroDescrição
    Não foi possível simular a antecipação de R$[valor]. Possíveis causas:
    • Nenhuma parcela atinge o valor solicitado. Tente aumentar o valor.
    • Não foram encontrados recebíveis antecipáveis.

    Relatórios para Conciliação

    GET v1/accounts/financial

    400

    ErroDescrição
    argument out of rangeO valor inserido em um dos parâmetros não cumpriu os limites.
    mday out of rangeO valor inserido no parâmetro day não cumpriu os limites de data (1-31).
    mon out of rangeO valor inserido no parâmetro month não cumpriu os limites de data (1-12).

    GET v1/withdraw_conciliations

    400

    ErroDescrição
    date: Formato de data inválido para $start_dateO parâmetro from aceita valores no formato ISO8061 (2018-05-01T14:30:00-03:00)
    date: Formato de data inválido para $end_date'O parâmetro to aceita valores no formato ISO8061 (2018-05-01T14:30:00-03:00)

    Pagamentos de Boletos

    POST v1/payment_requests

    🚧

    Assinatura RSA

    Este endpoint obriga informar a Assinatura RSA. Saiba mais.

    400

    ErroDescrição
    barcode is invalidO valor inserido no parâmetro barcode não é válido ou está vazio.

    Conta de Pagamento e Markeplace

    POST v1/marketplace/create_account

    400

    ErroDescrição
    Apenas uma criação de subconta pode ser processada por vez. Por favor, tente novamente em breve.Só é possível criar uma subconta por requisição.
    Essa conta não tem autorização de marketplaceA Conta Mestre em questão não tem acesso ao recurso Marketplace. Entre em contato com o Suporte.
    Recipient account não pode ficar em brancoO parâmetro recepient_account é obrigatório.
    Conta do destinatário inválidaO valor informado no parâmetro recepient_account é inválido ou está vazio.
    Split deve ter valor em centavos ou em percentualEnquanto o parâmetro permit_aggregated for null ou false, só é possível utilizar apenas cents ou percent.

    POST v1/accounts/{account_id}/request_verification

    ❗️

    Utilize dados reais

    Este endpoint não aceita valores fictícios.

    422

    ErroDescrição
    account: dígito invalido. (Formato: Conta: [formato])O valor informado no parâmetro bank_cc não cumpre o formato exigido. Saiba mais.
    agency: dígito invalido. (Formato: Agência: [formato])O valor informado no parâmetro bank_ag não cumpre o formato exigido. Saiba mais .
    cpf: is invalidO valor informado no parâmetro cpf é inválido. Não utilize dados fictícios.
    bank: is invalidO valor informado no parâmetro bank é inválido. Utilize, exatamente, as strings presentes na descrição do parâmetro bank. Saiba mais.
    account: account already verifiedSó é possível verificar uma subconta uma única vez.
  • Se deseja alterar dados bancários utilize a API Adicionar Domicílio Bancário
  • cpf_cnpj: operação não permitida?
    account_type: is invalidO valor informado no parâmetro account_type é inválido. Preencha, exatamente, com uma das strings Corrente, Poupança ou Pagamento.
    person_type: is invalidO valor informado no parâmetro person_type é inválido. Preencha, exatamente, com uma das strings Pessoa Física ou Pessoa Jurídica.

    POST v1/bank_verification

    ❗️

    Utilize dados reais

    Este endpoint não aceita valores fictícios.

    422

    ErroDescrição
    Essa conta já está cadastrada com esse domicílio bancárioUtilize outra conta bancária.
    agency: dígito invalido. (Formato: Agência: [formato])O valor informado no parâmetro agency não cumpre o formato exigido. Saiba mais .
    account: dígito invalido. (Formato: Conta: [formato])O valor informado no parâmetro account não cumpre o formato exigido. Saiba mais .
    bank: is invalidO valor informado no parâmetro bank é inválido. Utilize, exatamente, as strings presentes na descrição do parâmetro bank. Saiba mais .
    Sua conta precisa ser verificada antes de mudar o domicílio bancárioUtilize a API Enviar Verificação de Subconta para verificá-la.
    account_type: is invalidO valor informado no parâmetro account_type é inválido. Preencha, exatamente, com uma das strings cp, cc ou cpg.

    PUT v1/payments/pix

    ErroDescrição
    Pix must be enabledPara desativar (enable:false), antes, deve estar ativado.

    Transferência para Terceiros

    POST v1/transfer_requests

    ErroDescrição
    amount_cents: maior que o saldo da conta R$ [valor]O valor informando no parâmetro amount_cents é maior do que o saldo disponível para saque (balance_available_for_withdraw). Consulte o valor via Alia ou pela API Informações da Conta.
    amount_cents: greater than account balance.O valor informando no parâmetro amount_cents é maior do que o saldo disponível para saque (balance_available_for_withdraw). Consulte o valor via Alia ou pela API Informações da Conta .
    pix_key: Invalid CPFValor informado no parâmetro key do objeto pix inválido.
    Can't create a transfer request to iugu. Use the 'Transfer between iugu accounts' feature for this.Entre em contato com o Suporte .
    amount_cets: transfers quantity limit per profile exceeded.Limite de valor para transferências atingido. Entre em contato com o Suporte para aumentá-lo.

    Cartão de Crédito - Zero Auth

    POST v1/zero_auth

    400

    ErroDescrição
    token: must be a kind of: StringO valor informado no parâmetro token não é uma string.
    token: can't be blankO parâmetro token é obrigatório.

    422

    ErroDescrição
    zero_auto: Autorizacao negada (acompanhada de "code: [LR]")Consulte nossa Tabela de LRs.
    zero_auth: Bandeira Inválida.Bandeiras suportadas: Visa, Master e Elo.