# Pourquoi l’API renvoie-t-elle l’erreur 402 Insufficient credits ?

> Corrigez les erreurs 402 Insufficient credits de l’API Emailit en achetant des crédits, en activant la recharge automatique ou en attendant le renouvellement mensuel de vos crédits.

Cet article explique l’erreur `402` que vous obtenez lorsque votre espace de travail n’a pas assez de crédits pour une requête, et comment éviter qu’elle n’interrompe de nouveau vos envois.

## Symptômes

`POST /v2/emails` (ou la relance et le transfert) renvoie `402` :

```json
{
  "error": "Insufficient credits",
  "message": "Insufficient credits to send this email. Required: 3, available: 1."
}
```

Autres signes :

- Les requêtes de vérification d’e-mails renvoient `402` avec `Insufficient credits for email verification list.` ou un message similaire.
- Les e-mails entrants sont refusés avec `452 Insufficient credits to receive inbound email`.
- La jauge **Credits**, en bas de la barre latérale du tableau de bord, affiche `0 left` ou presque.

## Cause

Chaque action facturable consomme des crédits :

| Action | Crédits |
| --- | --- |
| E-mail envoyé via l’API ou SMTP (par destinataire) | 1 |
| E-mail entrant reçu | 1 |
| E-mail de campagne (par destinataire) | 2 |
| Exécution d’automatisation | 3 |
| Vérification d’e-mail (par adresse) | 5 |

L’API vérifie le coût total d’une requête avant de l’accepter. Un message avec 3 destinataires répartis entre `to`, `cc` et `bcc` nécessite 3 crédits. Si vous en avez moins, toute la requête est rejetée et rien n’est débité.

Votre solde se compose de deux parties : les crédits inclus chaque mois dans votre forfait, utilisés en premier, et les crédits achetés, qui n’expirent jamais. Quand les deux sont épuisés, l’envoi s’arrête.

## Solution

1. **Vérifiez votre solde.** Ouvrez **Workspace → Billing** et sélectionnez **Billable usage**. **Credits remaining** indique ce qu’il vous reste, et le graphique montre quels produits ont consommé vos crédits.

2. **Achetez des crédits.** Dans **Billable usage**, choisissez un montant entre 20 $ et 500 $ et sélectionnez **Purchase**. Vous pouvez aussi utiliser **Top up** dans la barre latérale. Seuls les administrateurs de l’espace de travail peuvent acheter des crédits. Les crédits achetés sont disponibles immédiatement.

3. **Relancez les requêtes en échec.** Une requête `402` n’a été ni envoyée ni débitée : vous pouvez donc la renvoyer telle quelle. Utilisez l’en-tête [`Idempotency-Key`](/fr/docs/email-api/idempotency/) si votre tâche risque d’envoyer deux fois.

4. **Activez la recharge automatique.** Dans **Workspace → Billing**, activez **Auto-refill**, puis définissez le **Refill amount** et le **Minimum credit threshold**. Emailit achète automatiquement des crédits quand votre solde passe sous le seuil. Consultez [Recharge automatique](/fr/docs/billing/auto-refill/).

5. **Envisagez un forfait.** Pro et Business incluent davantage de crédits mensuels et un prix plus bas pour les crédits supplémentaires. Consultez [Forfaits](/fr/docs/billing/plans/) et les [tarifs](/pricing/).

Les e-mails SMTP et de campagne ne reçoivent pas de `402`. Ils sont débités au moment où Emailit les traite et, si les crédits sont épuisés à ce moment-là, ils sont retenus avec le motif `Workspace has not enough email credits to send this email.` Les e-mails retenus ne sont pas libérés automatiquement quand vous ajoutez des crédits. Pour les renvoyer, consultez [Pourquoi mon e-mail est-il retenu ?](/fr/docs/kb/email-status-held/), et pour le détail de la facturation, [Comment les crédits sont-ils débités par destinataire ?](/fr/docs/kb/how-credits-are-charged-per-recipient/).

## Le problème persiste ?

Si votre solde vous semble incorrect, [contactez le support](/contact/) ou posez votre question sur [Discord](https://discord.emailit.com) en indiquant le nom de votre espace de travail et l’heure de la requête en échec.

---
Source: https://emailit.com/fr/docs/kb/402-insufficient-credits/