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

# Crediti e fatturazione

> Scopri come i crediti dell'API Enrow vengono consumati per ogni endpoint, come controllare il tuo saldo, gestire il rinnovo automatico e la ricarica, e gestire i crediti insufficienti

Enrow utilizza un sistema basato su crediti e i crediti vengono consumati solo quando viene trovato un risultato o viene eseguito un controllo. Questa pagina spiega come vengono addebitati i crediti per ogni endpoint, come controllare il tuo saldo, come gestire le impostazioni di fatturazione e cosa succede quando i crediti si esauriscono.

## Come funzionano i crediti?

I crediti vengono consumati solo quando l'API restituisce un risultato o completa un controllo: le ricerche fallite che non trovano nulla non costano crediti. Ogni funzionalità consuma crediti a una tariffa diversa:

| Endpoint           | Crediti                                                      |
| ------------------ | ------------------------------------------------------------ |
| **Email Finder**   | 1 per email trovata                                          |
| **Phone Finder**   | 40 per telefono trovato (predefinito; 50 con i piani legacy) |
| **Email Verifier** | 0,25 per controllo                                           |

<Note>
  I crediti vengono addebitati allo stesso modo per le operazioni singole e in blocco: per singolo risultato. Eseguire una [ricerca email in blocco](/it/api-reference/email-finder/find-bulk) di 1.000 nomi costa, per email trovata, quanto 1.000 ricerche singole.
</Note>

Ogni richiesta che consuma crediti restituisce un campo `credits_used` nella sua risposta, così puoi monitorare il consumo per ogni ricerca. Vedi [Trova email](/it/api-reference/email-finder/find-single) per un esempio di risposta.

## Come controllo il mio saldo di crediti?

Interroga l'endpoint dell'account con la tua chiave API nell'header `x-api-key` per recuperare il tuo saldo di crediti attuale. Non è necessario alcun payload nel corpo: l'account viene identificato dalla chiave 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"]
}
```

La risposta contiene il tuo saldo e i webhook registrati:

| Campo      | Descrizione                                 |
| ---------- | ------------------------------------------- |
| `credits`  | Il tuo saldo di crediti attuale             |
| `webhooks` | Array degli URL dei tuoi webhook registrati |

Per il riferimento completo dell'endpoint, vedi [Informazioni account](/it/api-reference/account/info). Puoi anche visitare la tua [Dashboard](https://app.enrow.io) per visualizzare i dettagli di utilizzo e fatturazione, oppure consultare la guida [Autenticazione](/it/authentication) per scoprire come funziona l'header `x-api-key` su ogni endpoint.

## Come gestisco le impostazioni di fatturazione?

Dalla [pagina di fatturazione](https://app.enrow.io/billing) nell'app, puoi configurare tre opzioni che mantengono il tuo account rifornito e ti avvisano prima che i crediti si esauriscano:

<AccordionGroup>
  <Accordion title="Rinnovo automatico">
    Rinnova automaticamente il tuo piano alla scadenza. Imposta la quantità di crediti da rinnovare nel campo di input accanto all'interruttore.
  </Accordion>

  <Accordion title="Ricarica automatica">
    Acquista automaticamente crediti pay-as-you-go aggiuntivi quando il tuo saldo è basso. Imposta la quantità di crediti da ricaricare nel campo di input accanto all'interruttore.
  </Accordion>

  <Accordion title="Avviso saldo basso">
    Ricevi un avviso via email quando il saldo dei tuoi crediti scende al di sotto di una soglia. Imposta la soglia di crediti nel campo di input accanto all'interruttore.
  </Accordion>
</AccordionGroup>

## Cosa succede quando i crediti si esauriscono?

Quando il saldo dei tuoi crediti raggiunge lo zero, le richieste API restituiscono uno stato HTTP `402`. Gli endpoint singoli (trova email/telefono singolo, verifica singola) restituiscono:

```json theme={null}
{
  "reason": "Insufficient credits",
  "success": false
}
```

Gli endpoint in blocco restituiscono invece `{ "message": "..." }`. Per l'elenco completo dei codici di stato e delle forme delle risposte, vedi [Codici di stato](/it/status-codes) e [Gestione degli errori](/it/error-handling).

<Warning>
  Per evitare interruzioni, abilita la **Ricarica automatica** o l'**Avviso saldo basso** dalla [pagina di fatturazione](https://app.enrow.io/billing).
</Warning>

## Quale piano dovrei scegliere?

Visita [enrow.io/pricing](https://enrow.io/pricing) per confrontare i piani e trovare quello più adatto alle tue esigenze. I crediti pay-as-you-go possono essere aggiunti a qualsiasi piano tramite la [Ricarica automatica](#how-do-i-manage-billing-settings).

## FAQ

<AccordionGroup>
  <Accordion title="Le ricerche fallite costano crediti?">
    No. I crediti vengono consumati solo quando viene trovata un'email o un numero di telefono, oppure quando viene eseguito un controllo di verifica. Una ricerca che non restituisce alcun risultato non costa crediti.
  </Accordion>

  <Accordion title="Le operazioni in blocco costano meno di quelle singole?">
    No. I crediti vengono addebitati per singolo risultato, quindi un'operazione in blocco costa, per email, telefono o verifica trovata, quanto le richieste singole equivalenti. Gli endpoint in blocco fanno risparmiare sulle richieste, non sui crediti.
  </Accordion>

  <Accordion title="Quanti crediti costa una verifica email?">
    L'Email Verifier consuma 0,25 crediti per controllo. L'Email Finder consuma 1 credito per email trovata e il Phone Finder consuma 40 crediti per telefono trovato (50 con i piani legacy).
  </Accordion>

  <Accordion title="Quale errore ricevo quando non ho più crediti?">
    Le richieste restituiscono uno stato HTTP `402`. Gli endpoint singoli restituiscono `{ "reason": "Insufficient credits", "success": false }`, mentre gli endpoint in blocco restituiscono `{ "message": "..." }`. Vedi [Gestione degli errori](/it/error-handling) per i dettagli.
  </Accordion>
</AccordionGroup>

## Passaggi successivi

<CardGroup cols={2}>
  <Card title="Autenticazione" icon="key" href="/it/authentication">
    Come passare la tua chiave API nell'header x-api-key.
  </Card>

  <Card title="Informazioni account" icon="circle-user" href="/it/api-reference/account/info">
    Recupera il tuo saldo di crediti e i webhook registrati.
  </Card>

  <Card title="Limiti di frequenza" icon="gauge-high" href="/it/rate-limits">
    Comprendi i limiti delle richieste API prima di scalare.
  </Card>

  <Card title="Gestione degli errori" icon="triangle-exclamation" href="/it/error-handling">
    Gestisci con eleganza il 402 e le altre risposte di errore.
  </Card>
</CardGroup>