Corrigindo o erro de "créditos insuficientes"

Quase sempre causado por um recurso pago em um fluxo de trabalho que você esperava que fosse gratuito - marca branca, AML, NFC ou prova de vida ativa. Veja como descobrir qual é e como evitar que se repita.

Escrito pelo suporte da Didit · Atualizado em 15 de setembro de 2026

Se uma solicitação de verificação falhar com "You don't have enough credits to perform this request", o saldo da sua organização não consegue cobrir um recurso que o fluxo de trabalho está tentando rodar.

A API informa a mesma condição com o código de erro insufficient_credits ao criar uma sessão. Dois esclarecimentos que poupam tickets: no fluxo, os métodos de prova de vida ativos se chamam Flash 3D e Ação 3D e Flash, e só Liveness passivo é gratuito; e a validação em bases de dados e a verificação de telefone precisam ainda de uma primeira recarga antes de rodar (os US$ 10 de boas-vindas não contam). Veja validação em bases de dados.

#Verifique o fluxo de trabalho antes de verificar o saldo

O instinto é olhar para o seu consumo. Olhe primeiro para o seu fluxo de trabalho, porque o nível gratuito cobre apenas estes quatro recursos, cada um com sua própria cota de 500 verificações gratuitas por mês:

• Verificação de documento
• Prova de vida passiva
• Correspondência facial 1:1
• Análise de dispositivo e IP

Todo outro módulo é cobrado desde a primeira verificação, em qualquer volume. Os culpados de sempre, na ordem em que costumam aparecer:

#Corrigindo o problema

1. Abra o fluxo de trabalho usado pela sessão que falhou

   Não qualquer fluxo de trabalho - o que tem o ID com o qual a sessão foi criada. Em Fluxos de trabalho, confira cada recurso habilitado contra a tabela acima.

2. Confira também a aba Options

   A marca branca é habilitada por fluxo de trabalho em Configurações → Opções → Include custom style, e não na lista de etapas, então é fácil não perceber ao auditar as etapas.

3. Confira o seu saldo

   Configurações → Faturamento mostra o seu saldo atual. Se estiver negativo, todo o trabalho faturável para - incluindo suas verificações do nível gratuito - até voltar para acima de zero.

4. Remova o recurso pago ou recarregue

   Se você não precisa do recurso pago, desative-o e republique. Se precisa, adicione fundos - a recarga mínima é US$ 50. Veja recargas, faturas e métodos de pagamento.

12

1. Adicionar crédito resolve o erro imediatamente.
2. Confirme que uma recarga realmente foi concluída antes de presumir que o saldo está errado.

#Outras causas que vale a pena descartar

• Um saldo negativo. Assim que o saldo cai abaixo de zero, as verificações do nível gratuito também param. Esse é o caso em que o erro genuinamente não é sobre um recurso pago.

• A chave da aplicação errada. O saldo é por organização, mas se você está chamando com uma chave de uma aplicação cujo fluxo de trabalho é diferente do que você auditou, você está olhando para a configuração errada. Veja organizações, aplicações e ambientes.

• Uma chamada de API isolada em vez de uma sessão de fluxo de trabalho. Chamadas isoladas são cobradas por chamada, sem cota gratuita, mesmo para recursos que são gratuitos dentro de um fluxo de trabalho.

• Você realmente usou as 500 de um recurso. Confira o volume do mês por recurso em Analytics antes de presumir que é esse o caso - e lembre-se de que cada um dos quatro tem sua própria cota, então essa é a explicação menos provável em baixo volume.

• Verificação de telefone ou validação em bases de dados antes de qualquer recarga. Ambas ficam inativas até sua organização fazer uma primeira recarga real; créditos de boas-vindas não as desbloqueiam. Veja recargas, faturas e formas de pagamento.

• Um sandbox que funcionava e uma aplicação de produção que não funciona. O sandbox nunca cobra nada, então não pode revelar um recurso pago. A primeira sessão em produção é onde o preço real do fluxo aparece.

#Evitando que aconteça de novo

• Ative a recarga automática em Configurações → Faturamento para que o saldo se recarregue sozinho abaixo de um limite escolhido por você.
• Teste em sandbox, onde nada é cobrado e a verificação de saldo é totalmente ignorada. Veja testando em sandbox.
• Separe suas aplicações de teste e produção, para que um experimento não possa drenar o saldo do qual o seu tráfego de produção depende.

#Limitando o seu gasto

Se você quer um teto rígido para que uma conta não possa ficar negativa durante os testes, isso é um controle no nível da conta, não uma configuração de fluxo de trabalho - pergunte ao suporte o que está disponível para a sua organização. Enquanto isso, a versão prática é: continue testando em uma aplicação sandbox, onde não há nada a gastar.

#Se as recargas não forem autoatendidas

Organizações em um plano anual não conseguem comprar créditos pelo fluxo de recarga autoatendido - contate o seu gerente de conta em vez disso. Uma tentativa autoatendida vai avisar disso, em vez de simplesmente falhar sem explicação.

#Se o seu saldo parece errado

Se o seu saldo, faturas ou histórico de verificação de repente parecerem ausentes ou incorretos, isso é quase sempre um problema temporário da plataforma, não dados perdidos. Contate o suporte em vez de tentar corrigir por conta própria, e inclua o ID da sua organização.