Por que recebo o erro 402 Insufficient credits?

Este artigo explica o erro 402 que você recebe quando o seu workspace não tem créditos suficientes para uma requisição e como garantir que ele não interrompa os seus envios de novo.

Sintomas

POST /v2/emails (ou as novas tentativas e encaminhamentos) retorna 402:

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

Sinais relacionados:

• As requisições de verificação de e-mails retornam 402 com Insufficient credits for email verification list. ou uma mensagem parecida.
• E-mails recebidos são recusados com 452 Insufficient credits to receive inbound email.
• O medidor Credits na parte de baixo da barra lateral do painel mostra 0 left ou um valor próximo disso.

Causa

Toda ação cobrada usa créditosCréditoA unidade de cobrança do Emailit. Cada ação custa um número fixo de créditos, por exemplo 1 por e-mail via API ou SMTP e 2 por e-mail de campanha.:

A API verifica o custo total de uma requisição antes de aceitá-la. Uma mensagem com 3 destinatários entre to, cc e bcc precisa de 3 créditos. Se você tiver menos, a requisição inteira é rejeitada e nada é cobrado.

O seu saldo tem duas partes: os créditos incluídos no seu plano a cada mês, usados primeiro, e os créditos comprados, que nunca expiram. Quando as duas acabam, o envio para.

Solução

1. Confira o seu saldo. Abra Workspace›Billing e selecione Billable usage. Credits remaining mostra o que resta, e o gráfico mostra quais produtos usaram os créditos.

2. Compre créditos. Em Billable usage, escolha um valor entre US$ 20 e US$ 500 e selecione Purchase. Você também pode usar Top up na barra lateral. Apenas administradores do workspace podem comprar créditos. Os créditos comprados ficam disponíveis na hora.

3. Tente de novo as requisições que falharam. Uma requisição com 402 não foi enviada nem cobrada, então você pode reenviá-la como está. Use uma Idempotency-Key se o seu job puder reenviar duas vezes.

4. Ative a recarga automática. Em Workspace›Billing, ative Auto-refill e defina o Refill amount e o Minimum credit threshold. O Emailit compra créditos automaticamente quando o seu saldo fica abaixo do valor mínimo. Consulte Recarga automática.

5. Considere um plano. O Pro e o Business incluem mais créditos mensais e um preço menor para os créditos extras. Consulte Planos e preços.

E-mails por SMTP e de campanha não recebem 402. Eles são cobrados quando o Emailit os processa e, se os créditos acabarem nesse momento, ficam retidos com o motivo Workspace has not enough email credits to send this email. Os e-mails retidos não são liberados automaticamente quando você adiciona créditos. Consulte Por que o meu e-mail está retido? para reenviá-los e Como os créditos são cobrados por destinatário? para os detalhes da cobrança.

Ainda com problemas?

Se o seu saldo parecer errado, fale com o suporte ou pergunte no Discord, informando o nome do workspace e o horário da requisição que falhou.