> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Créditos e Cobrança

> Saiba como os créditos da API da Enrow são consumidos por endpoint, verifique seu saldo, gerencie a renovação automática e a recarga, e lide com créditos insuficientes

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:

| Endpoint           | Créditos                                                   |
| ------------------ | ---------------------------------------------------------- |
| **Email Finder**   | 1 por email encontrado                                     |
| **Phone Finder**   | 40 por telefone encontrado (padrão; 50 com planos legados) |
| **Email Verifier** | 0,25 por verificação                                       |

<Note>
  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](/pt/api-reference/email-finder/find-bulk) de 1.000 nomes custa o mesmo por email encontrado que 1.000 buscas individuais.
</Note>

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](/pt/api-reference/email-finder/find-single) 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.

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Response theme={null}
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
```

A resposta contém seu saldo e os webhooks registrados:

| Campo      | Descrição                                |
| ---------- | ---------------------------------------- |
| `credits`  | Seu saldo de créditos atual              |
| `webhooks` | Array com as URLs de webhook registradas |

Para a referência completa do endpoint, veja [Informações da conta](/pt/api-reference/account/info). Você também pode acessar seu [Dashboard](https://app.enrow.io) para visualizar detalhes de uso e cobrança, ou consultar o guia de [Autenticação](/pt/authentication) 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](https://app.enrow.io/billing) do app, você pode configurar três opções que mantêm sua conta abastecida e alertam você antes que os créditos acabem:

<AccordionGroup>
  <Accordion title="Renovação automática">
    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.
  </Accordion>

  <Accordion title="Recarga automática">
    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.
  </Accordion>

  <Accordion title="Alerta de saldo baixo">
    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.
  </Accordion>
</AccordionGroup>

## 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:

```json theme={null}
{
  "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](/pt/status-codes) e [Tratamento de erros](/pt/error-handling).

<Warning>
  Para evitar interrupções, ative a **Recarga automática** ou o **Alerta de saldo baixo** na [página de Cobrança](https://app.enrow.io/billing).
</Warning>

## Qual plano devo escolher?

Acesse [enrow.io/pricing](https://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](#how-do-i-manage-billing-settings).

## FAQ

<AccordionGroup>
  <Accordion title="Buscas malsucedidas custam créditos?">
    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.
  </Accordion>

  <Accordion title="As operações em lote são mais baratas que as individuais?">
    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.
  </Accordion>

  <Accordion title="Quantos créditos custa uma verificação de email?">
    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).
  </Accordion>

  <Accordion title="Qual erro recebo quando não tenho mais créditos?">
    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](/pt/error-handling) para mais detalhes.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/pt/authentication">
    Como passar sua chave de API no cabeçalho x-api-key.
  </Card>

  <Card title="Informações da conta" icon="circle-user" href="/pt/api-reference/account/info">
    Recupere seu saldo de créditos e os webhooks registrados.
  </Card>

  <Card title="Limites de taxa" icon="gauge-high" href="/pt/rate-limits">
    Entenda os limites de requisições da API antes de escalar.
  </Card>

  <Card title="Tratamento de erros" icon="triangle-exclamation" href="/pt/error-handling">
    Lide com respostas de erro 402 e outras de forma elegante.
  </Card>
</CardGroup>