Perché ricevo l’errore 402 Insufficient credits?

Questo articolo spiega l’errore 402 che ricevi quando il workspace non ha crediti sufficienti per una richiesta, e come evitare che blocchi di nuovo i tuoi invii.

Sintomi

POST /v2/emails (o il nuovo tentativo e l’inoltro) restituisce 402:

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

Altri segnali:

• Le richieste di verifica email restituiscono 402 con Insufficient credits for email verification list. o un messaggio simile.
• Le email in entrata vengono rifiutate con 452 Insufficient credits to receive inbound email.
• L’indicatore Credits in fondo alla barra laterale del pannello mostra 0 left o un valore vicino.

Causa

Ogni azione a pagamento usa creditiCreditoL’unità con cui Emailit fattura. Ogni azione costa un numero fisso di crediti, ad esempio 1 per un’email via API o SMTP e 2 per un’email di una campagna.:

L’API controlla il costo totale di una richiesta prima di accettarla. Un messaggio con 3 destinatari tra to, cc e bcc richiede 3 crediti. Se ne hai meno, l’intera richiesta viene rifiutata e non viene addebitato nulla.

Il saldo ha due parti: i crediti inclusi nel piano ogni mese, usati per primi, e i crediti acquistati, che non scadono mai. Quando entrambi sono esauriti, l’invio si ferma.

Soluzione

1. Controlla il saldo. Apri Workspace›Billing e seleziona Billable usage. Credits remaining mostra quanti crediti restano e il grafico mostra quali prodotti li hanno usati.

2. Acquista crediti. In Billable usage, scegli un importo tra 20 $ e 500 $ e seleziona Purchase. Puoi anche usare Top up nella barra laterale. Solo gli amministratori del workspace possono acquistare crediti. I crediti acquistati sono disponibili subito.

3. Ritenta le richieste non riuscite. Una richiesta con risposta 402 non è stata inviata né addebitata, quindi puoi inviarla di nuovo così com’è. Usa una Idempotency-Key se il tuo job potrebbe inviarla due volte.

4. Attiva la ricarica automatica. In Workspace›Billing, attiva Auto-refill e imposta Refill amount e Minimum credit threshold. Emailit acquista crediti automaticamente quando il saldo scende sotto la soglia. Vedi Ricarica automatica.

5. Valuta un piano. Pro e Business includono più crediti mensili e un prezzo più basso per i crediti extra. Vedi Piani e i prezzi.

Le email inviate via SMTP e quelle delle campagne non ricevono un 402. Vengono addebitate quando Emailit le elabora e, se a quel punto i crediti sono esauriti, vengono trattenute con il motivo Workspace has not enough email credits to send this email. Le email trattenute non vengono rilasciate automaticamente quando aggiungi crediti. Vedi Perché l’email è trattenuta? per inviarle di nuovo e Come vengono addebitati i crediti per destinatario? per i dettagli sull’addebito.

Serve ancora aiuto?

Se il saldo non ti sembra corretto, contatta il supporto o chiedi su Discord indicando il nome del workspace e l’ora della richiesta non riuscita.