Skip to main content
A Enrow usa um sistema baseado em créditos, e os créditos são consumidos quando um resultado é encontrado ou uma verificação é realizada. Esta página explica como os créditos são cobrados em cada endpoint, como verificar seu saldo, como gerenciar as configurações de cobrança e o que acontece quando os créditos acabam.

​
Como funcionam os créditos?

Os créditos só são consumidos quando a API retorna um resultado ou conclui uma verificação: buscas malsucedidas que não encontram nada não custam créditos, com duas exceções para o Email Finder (veja abaixo). Cada recurso consome créditos a uma taxa diferente:
Os créditos são cobrados da mesma forma para operações individuais e em lote — por resultado individual. Executar uma busca de emails em lote de 1.000 nomes custa o mesmo por email encontrado que 1.000 buscas individuais.
Duas exceções para o Email Finder: uma conta cuja taxa de sucesso continua anormalmente baixa paga, após um aviso, 0,25 crédito por busca sem resultado, e uma busca a partir da URL de um perfil do LinkedIn custa 0,25 crédito se nenhum email for encontrado. Veja o FAQ abaixo.
Toda requisição que consome créditos retorna um campo credits_used em sua resposta, para que você possa acompanhar o consumo por busca. Veja Buscar Email para um exemplo de resposta.

​
Como verifico meu saldo de créditos?

Consulte o endpoint da conta com sua chave de API no cabeçalho x-api-key para recuperar seu saldo de créditos atual. Nenhum payload no corpo é necessário — a conta é identificada a partir da chave de API.
Response
A resposta contém seu saldo e os webhooks registrados: Para a referência completa do endpoint, veja Informações da conta. Você também pode acessar seu Dashboard para visualizar detalhes de uso e cobrança, ou consultar o guia de Autenticação para entender como o cabeçalho x-api-key funciona em todos os endpoints.

​
Como gerencio as configurações de cobrança?

Nos planos pagos, em Billing → Settings no app, você encontra duas configurações que mantêm sua conta abastecida de créditos e avisam você antes que eles acabem:
Recarrega seu saldo automaticamente assim que ele cai abaixo do limite que você define em Credit threshold (no mínimo 100 créditos). Escolha um dos dois modos:
  • Early renewal: seu plano é renovado na hora e inicia um novo ciclo com os créditos dele. Disponível apenas com uma assinatura ativa.
  • Pay-as-you-go top-up: é comprado um pacote de créditos pay-as-you-go, no volume que você escolhe em Top-up volume.
Se o seu saldo já estiver abaixo do limite quando você salvar, a recarga acontece na hora.
Envia um email para o endereço que você escolher quando o seu saldo cai abaixo de um valor definido. Você também pode publicar esse alerta em um canal do Slack ou do Discord.

​
O que acontece quando os créditos acabam?

Quando seu saldo de créditos chega a zero, as requisições à API retornam o status HTTP 402. Os endpoints individuais (busca individual de email/telefone, verificação individual) retornam:
Os endpoints em lote retornam { "message": "..." } em vez disso. Para a lista completa de códigos de status e formatos de resposta, veja Códigos de status e Tratamento de erros.
Para evitar interrupções, ative a Balance protection ou um Credit Alert em Billing → Settings.

​
Qual plano devo escolher?

Acesse enrow.io/pricing para comparar os planos e encontrar a opção ideal para suas necessidades. Créditos pay-as-you-go podem ser adicionados a qualquer plano, manualmente ou automaticamente com a Balance protection.

​
FAQ

Não. Os créditos só são consumidos quando um email ou número de telefone é encontrado, ou quando uma verificação é realizada. Uma busca que não retorna nenhum resultado não custa créditos. Uma exceção, prevista na cláusula 8.6 dos nossos termos de serviço: se menos de 12% das buscas do Email Finder de uma conta encontram um email, com pelo menos 10.000 buscas em 7 dias, avisamos a conta por email. Se a taxa continuar tão baixa 7 dias depois, cada busca do Email Finder sem resultado custa 0,25 crédito até voltar a subir. Outra exceção: uma busca do Email Finder a partir da URL de um perfil do LinkedIn custa 0,25 crédito se nenhum email for encontrado. Falhas causadas por um incidente do nosso lado nunca são cobradas.
Não. Os créditos são cobrados por resultado individual, então uma operação em lote custa o mesmo por email, telefone ou verificação encontrados que as requisições individuais equivalentes. Os endpoints em lote economizam em requisições, não em créditos.
O Email Verifier consome 0,25 créditos por verificação. O Email Finder consome 1 crédito por email encontrado, e o Phone Finder consome 40 créditos por telefone encontrado (50 com planos legados).
As requisições retornam o status HTTP 402. Os endpoints individuais retornam { "reason": "Insufficient credits", "success": false }, enquanto os endpoints em lote retornam { "message": "..." }. Veja Tratamento de erros para mais detalhes.

​
Próximos passos

Autenticação

Como passar sua chave de API no cabeçalho x-api-key.

Informações da conta

Recupere seu saldo de créditos e os webhooks registrados.

Limites de taxa

Entenda os limites de requisições da API antes de escalar.

Tratamento de erros

Lide com respostas de erro 402 e outras de forma elegante.