Saltar para o conteúdo principal
A Enrow usa um sistema baseado em créditos, e os créditos só 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. Cada recurso consome créditos a uma taxa diferente:
EndpointCréditos
Email Finder1 por email encontrado
Phone Finder40 por telefone encontrado (padrão; 50 com planos legados)
Email Verifier0,25 por verificação
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.
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. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
A resposta contém seu saldo e os webhooks registrados:
CampoDescrição
creditsSeu saldo de créditos atual
webhooksArray com as URLs de webhook registradas
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?

Na página de Cobrança do app, você pode configurar três opções que mantêm sua conta abastecida e alertam você antes que os créditos acabem:
Renove automaticamente seu plano quando ele expirar. Defina a quantidade de créditos a renovar no campo ao lado do botão de alternância.
Compre automaticamente créditos adicionais pay-as-you-go quando seu saldo ficar baixo. Defina a quantidade de créditos a recarregar no campo ao lado do botão de alternância.
Receba um alerta por email quando seu saldo de créditos cair abaixo de um limite. Defina o limite de créditos no campo ao lado do botão de alternância.

​
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: 
{
  "reason": "Insufficient credits",
  "success": false
}
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 Recarga automática ou o Alerta de saldo baixo na página de Cobrança.

​
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 por meio da Recarga automática.

​
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.
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.