Resolver um erro de "créditos insuficientes"
Quase sempre causado por uma funcionalidade paga num fluxo de trabalho que esperavas que fosse gratuito - white label, AML, NFC ou prova de vida ativa. Aqui está como encontrar qual delas, e como evitar que se repita.
Nove em cada dez vezes isto não é um limite gratuito a esgotar-se. É uma funcionalidade paga no fluxo de trabalho - mais frequentemente white label (0,20 $), AML (0,20 $), NFC (0,15 $), ou prova de vida ativa (0,15 $). Abre o fluxo de trabalho e vê o que está ativado antes de carregares saldo.
Se um pedido de verificação falhar com "You don't have enough credits to perform this request", o saldo da tua organização não consegue cobrir uma funcionalidade que o fluxo de trabalho está a tentar correr.
A API comunica a mesma condição com o código de erro insufficient_credits ao criar uma sessão. Dois esclarecimentos que poupam pedidos de suporte: no fluxo, os métodos de prova de vida ativos chamam-se 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 um primeiro carregamento antes de correrem (os 10 $ de boas-vindas não contam). Veja validação em bases de dados.
#Verifica o fluxo de trabalho antes de verificares o saldo
O instinto é olhar para a tua utilização. Olha primeiro para o teu fluxo de trabalho, porque o plano gratuito cobre apenas estas quatro funcionalidades, cada uma com as suas próprias 500 comprovações gratuitas por mês:
- Verificação de identidade
- Prova de vida passiva
- Correspondência facial 1:1
- Análise de dispositivo e IP
Todos os outros módulos são faturados desde a primeira comprovação, seja qual for o volume. Os culpados habituais, pela ordem em que costumam aparecer:
| Funcionalidade | Preço | Porque surpreende as pessoas |
|---|---|---|
| White label / marca personalizada | 0,20 $ por verificação | É uma definição de aspeto e estilo, por isso não parece uma "comprovação" |
| Cribagem AML | 0,20 $ | Muitas vezes adicionada a um modelo de "KYC gratuito" sem se dar por isso |
| NFC | 0,15 $ | Faturado separadamente da verificação de identidade |
| Prova de vida ativa | 0,15 $ | Mudar de passiva para ativa sai do plano gratuito |
| Estimativa de idade | 0,10 $ | A verificação de identidade do plano gratuito não a cobre |
| Questionário | 0,10 $ | Parece um formulário, não uma comprovação |
| Verificação de telefone | a partir de 0,03 $ + taxa da operadora | A taxa da operadora varia consoante o destino |
| Verificação de e-mail | 0,03 $ | |
| Comprovativo de morada | 0,20 $ | |
| Validação em base de dados | Varia por país | |
| Verificação de negócio (KYB) | 2,00 $ |
O white label é a causa mais comum, isoladamente. Um fluxo de trabalho com marca personalizada ativada custa 0,20 $ por verificação concluída além dos preços por módulo - por isso um fluxo que configuraste como KYC gratuito torna-se um fluxo pago no momento em que lhe pões marca. Consulta personalizar a marca e a experiência.
#Resolver
- Abre o fluxo de trabalho que a sessão falhada usa
Não um fluxo de trabalho qualquer - aquele com cujo ID a sessão foi criada. Em Fluxos de Trabalho, verifica cada funcionalidade ativada contra a tabela acima.
- Verifica também o separador Options
O white label é ativado por fluxo de trabalho em Definições → Opções → Incluir estilo personalizado, e não na lista de passos, por isso é fácil de não notar ao auditares os passos.
- Verifica o teu saldo
Definições → Faturação mostra o teu saldo atual. Se estiver negativo, todo o trabalho faturável para - incluindo as tuas comprovações do plano gratuito - até voltar a ficar acima de zero.
- Remove a funcionalidade paga ou carrega saldo
Se não precisares da funcionalidade paga, desativa-a e republica. Se precisares, adiciona fundos - o carregamento mínimo é 50 $. Consulta carregamentos, faturas e formas de pagamento.
- Adicionar crédito resolve o erro imediatamente.
- Confirma que um carregamento chegou mesmo antes de presumires que o saldo está errado.
#Outras causas a excluir
-
Um saldo negativo. Assim que o saldo fica abaixo de zero, as comprovações do plano gratuito também param. Este é o caso em que o erro genuinamente não tem a ver com uma funcionalidade paga.
-
A chave da aplicação errada. O saldo é por organização, mas se estiveres a chamar com uma chave de uma aplicação cujo fluxo de trabalho é diferente do que auditaste, estás a olhar para a configuração errada. Consulta organizações, aplicações e ambientes.
-
Uma chamada de API isolada em vez de uma sessão de fluxo de trabalho. As chamadas isoladas são faturadas por chamada e sem limite gratuito, mesmo para funcionalidades que são gratuitas dentro de um fluxo de trabalho.
-
Usaste mesmo as 500 de uma funcionalidade. Verifica as Analytics quanto ao volume do mês por funcionalidade antes de presumires isto - e lembra-te de que cada uma das quatro tem o seu próprio limite, por isso é a explicação menos provável a baixo volume.
-
Verificação de telefone ou validação em bases de dados antes de qualquer carregamento. Ambas ficam inativas até a sua organização fazer um primeiro carregamento real; os créditos de boas-vindas não as desbloqueiam. Veja carregamentos, faturas e métodos de pagamento.
-
Um sandbox que funcionava e uma aplicação de produção que não funciona. O sandbox nunca cobra nada, por isso não pode revelar uma funcionalidade paga. A primeira sessão em produção é onde o preço real do fluxo aparece.
#Evitar que volte a acontecer
- Ativa a recarga automática em Definições → Faturação para que o saldo se carregue automaticamente abaixo de um limiar que escolheres.
- Testa em sandbox, onde nada é faturado e a verificação de saldo é completamente ignorada. Consulta testar em sandbox.
- Separa as tuas aplicações de teste e de produção, para que uma experiência não consiga esgotar o saldo de que o teu tráfego em produção depende.
#Limitar a tua despesa
Se quiseres um teto rígido para que uma conta não consiga ficar negativa durante os testes, isso é um controlo ao nível da conta e não uma definição de fluxo de trabalho - pergunta ao suporte o que está disponível para a tua organização. Entretanto, a versão prática é: continua a testar numa aplicação sandbox, onde não há nada a gastar.
#Se os carregamentos não forem self-service
As organizações num plano anual não conseguem comprar créditos através do fluxo de carregamento self-service - contacta o teu gestor de conta em vez disso. Uma tentativa self-service vai avisar-te disso em vez de falhar silenciosamente.
#Se o teu saldo parecer errado
Se o teu saldo, faturas ou histórico de verificação parecerem de repente em falta ou incorretos, isto é quase sempre um problema temporário da plataforma e não dados perdidos. Contacta o suporte em vez de tentares resolver isto sozinho, e inclui o ID da tua organização.