> ## 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édits et facturation

> Découvrez comment les crédits de l'API Enrow sont consommés par endpoint, comment vérifier votre solde, gérer le renouvellement automatique et le rechargement, et gérer les crédits insuffisants

Enrow utilise un système basé sur les crédits, et les crédits ne sont consommés que lorsqu'un résultat est trouvé ou qu'une vérification est effectuée. Cette page explique comment les crédits sont facturés pour chaque endpoint, comment vérifier votre solde, comment gérer les paramètres de facturation et ce qui se passe lorsque les crédits sont épuisés.

## Comment fonctionnent les crédits ?

Les crédits ne sont consommés que lorsque l'API renvoie un résultat ou termine une vérification — les recherches infructueuses qui ne trouvent rien ne coûtent pas de crédits. Chaque fonctionnalité consomme des crédits à un taux différent :

| Endpoint           | Crédits                                                          |
| ------------------ | ---------------------------------------------------------------- |
| **Email Finder**   | 1 par email trouvé                                               |
| **Phone Finder**   | 40 par numéro trouvé (par défaut ; 50 avec les anciens forfaits) |
| **Email Verifier** | 0,25 par vérification                                            |

<Note>
  Les crédits sont facturés de la même manière pour les opérations unitaires et groupées — par résultat individuel. Lancer une [recherche d'emails groupée](/fr/api-reference/email-finder/find-bulk) sur 1 000 noms coûte le même prix par email trouvé que 1 000 recherches unitaires.
</Note>

Chaque requête qui consomme des crédits renvoie un champ `credits_used` dans sa réponse, ce qui vous permet de suivre la consommation par recherche. Consultez [Trouver un email](/fr/api-reference/email-finder/find-single) pour un exemple de réponse.

## Comment vérifier mon solde de crédits ?

Interrogez l'endpoint du compte avec votre clé d'API dans l'en-tête `x-api-key` pour récupérer votre solde de crédits actuel. Aucun corps de requête n'est nécessaire — le compte est identifié à partir de la clé d'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 réponse contient votre solde et vos webhooks enregistrés :

| Field      | Description                                 |
| ---------- | ------------------------------------------- |
| `credits`  | Votre solde de crédits actuel               |
| `webhooks` | Tableau des URL de vos webhooks enregistrés |

Pour la référence complète de l'endpoint, consultez [Infos du compte](/fr/api-reference/account/info). Vous pouvez également visiter votre [Tableau de bord](https://app.enrow.io) pour consulter les détails d'utilisation et de facturation, ou consulter le guide d'[Authentification](/fr/authentication) pour comprendre le fonctionnement de l'en-tête `x-api-key` sur tous les endpoints.

## Comment gérer les paramètres de facturation ?

Depuis la [page de facturation](https://app.enrow.io/billing) de l'application, vous pouvez configurer trois options qui maintiennent votre compte approvisionné et vous alertent avant que les crédits ne soient épuisés :

<AccordionGroup>
  <Accordion title="Renouvellement automatique">
    Renouvelez automatiquement votre forfait à son expiration. Définissez le montant de crédits à renouveler dans le champ de saisie situé à côté du bouton bascule.
  </Accordion>

  <Accordion title="Rechargement automatique">
    Achetez automatiquement des crédits supplémentaires à l'usage lorsque votre solde devient faible. Définissez le montant de crédits à recharger dans le champ de saisie situé à côté du bouton bascule.
  </Accordion>

  <Accordion title="Alerte de solde faible">
    Recevez une alerte par email lorsque votre solde de crédits descend en dessous d'un seuil. Définissez le seuil de crédits dans le champ de saisie situé à côté du bouton bascule.
  </Accordion>
</AccordionGroup>

## Que se passe-t-il lorsque les crédits sont épuisés ?

Lorsque votre solde de crédits atteint zéro, les requêtes API renvoient un statut HTTP `402`. Les endpoints unitaires (recherche d'email/de numéro unitaire, vérification unitaire) renvoient :

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

Les endpoints groupés renvoient plutôt `{ "message": "..." }`. Pour la liste complète des codes de statut et des formats de réponse, consultez [Codes de statut](/fr/status-codes) et [Gestion des erreurs](/fr/error-handling).

<Warning>
  Pour éviter toute interruption, activez le **Rechargement automatique** ou l'**Alerte de solde faible** depuis la [page de facturation](https://app.enrow.io/billing).
</Warning>

## Quel forfait choisir ?

Rendez-vous sur [enrow.io/pricing](https://enrow.io/pricing) pour comparer les forfaits et trouver celui qui correspond à vos besoins. Des crédits à l'usage peuvent être ajoutés à n'importe quel forfait via le [Rechargement automatique](#how-do-i-manage-billing-settings).

## FAQ

<AccordionGroup>
  <Accordion title="Les recherches infructueuses coûtent-elles des crédits ?">
    Non. Les crédits ne sont consommés que lorsqu'un email ou un numéro de téléphone est trouvé, ou lorsqu'une vérification est effectuée. Une recherche qui ne renvoie aucun résultat ne coûte pas de crédits.
  </Accordion>

  <Accordion title="Les opérations groupées sont-elles moins chères que les opérations unitaires ?">
    Non. Les crédits sont facturés par résultat individuel, donc une opération groupée coûte le même prix par email, numéro ou vérification trouvé que les requêtes unitaires équivalentes. Les endpoints groupés font économiser des requêtes, pas des crédits.
  </Accordion>

  <Accordion title="Combien de crédits coûte une vérification d'email ?">
    L'Email Verifier consomme 0,25 crédit par vérification. L'Email Finder consomme 1 crédit par email trouvé, et le Phone Finder consomme 40 crédits par numéro trouvé (50 avec les anciens forfaits).
  </Accordion>

  <Accordion title="Quelle erreur reçois-je lorsque je n'ai plus de crédits ?">
    Les requêtes renvoient un statut HTTP `402`. Les endpoints unitaires renvoient `{ "reason": "Insufficient credits", "success": false }`, tandis que les endpoints groupés renvoient `{ "message": "..." }`. Consultez [Gestion des erreurs](/fr/error-handling) pour plus de détails.
  </Accordion>
</AccordionGroup>

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/fr/authentication">
    Comment transmettre votre clé d'API dans l'en-tête x-api-key.
  </Card>

  <Card title="Infos du compte" icon="circle-user" href="/fr/api-reference/account/info">
    Récupérez votre solde de crédits et vos webhooks enregistrés.
  </Card>

  <Card title="Limites de débit" icon="gauge-high" href="/fr/rate-limits">
    Comprenez les limites de requêtes de l'API avant de monter en charge.
  </Card>

  <Card title="Gestion des erreurs" icon="triangle-exclamation" href="/fr/error-handling">
    Gérez correctement les réponses d'erreur 402 et autres.
  </Card>
</CardGroup>