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

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 :

{
  "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éditsCréditL’unité de facturation d’Emailit. Chaque action coûte un nombre fixe de crédits, par exemple 1 pour un e-mail via l’API ou SMTP et 2 pour un e-mail de campagne. :

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

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 et les tarifs.

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 ?, et pour le détail de la facturation, Comment les crédits sont-ils débités par destinataire ?.

Le problème persiste ?

Si votre solde vous semble incorrect, contactez le support ou posez votre question sur Discord en indiquant le nom de votre espace de travail et l’heure de la requête en échec.