Aller au contenu principal

Crédits SMTP

Fonctionnement​

Les crédits sont la monnaie interne pour les vérifications SMTP. Chaque vérification SMTP réussie consomme 1 crédit.

OpérationCoût
Syntaxe + DNS + Disposable + Role + TypoGratuit
Vérification SMTP (boîte réelle)1 crédit
Enrichissement (prénom probable)Inclus avec SMTP
Crédits non consommés

Les crédits ne sont pas consommés si :

  • L'email est sur la whitelist de l'organisation
  • L'email est sur la blacklist de l'organisation
  • L'email est détecté comme jetable avant l'SMTP
  • La vérification SMTP échoue côté serveur

Vérifier le solde​

curl https://api.yeswecheck.fr/v2/credits/balance \
  -H "Authorization: Bearer VOTRE_JWT"
{
  "balance": 4820,
  "organizationId": "uuid-de-votre-org"
}

Vérifier si le solde est suffisant​

curl https://api.yeswecheck.fr/v2/credits/check/100 \
  -H "Authorization: Bearer VOTRE_JWT"
{
  "hasEnoughCredits": true,
  "requiredAmount": 100
}

Acheter des crédits​

Les crédits s'achètent depuis le Dashboard → Facturation → Acheter des crédits.

Les packs disponibles sont affichés dans l'interface. Paiement sécurisé via Stripe.

Alertes de solde​

Configurez des alertes email depuis le Dashboard pour être notifié quand votre solde passe sous un seuil.

Crédits dans les réponses API​

Chaque réponse de validation inclut le compte dans metadata :

{
  "metadata": {
    "creditsUsed": 1,
    "creditsRemaining": 4819,
    "processingTimeMs": 2341,
    "smtpEnabled": true
  }
}

Erreur de solde insuffisant​

HTTP 402 Payment Required

{
  "message": "Insufficient credits for SMTP validation",
  "code": "INSUFFICIENT_CREDITS",
  "statusCode": 402
}

Gérez cette erreur dans votre code :

const response = await fetch('/v2/email/validate', {
  method: 'POST',
  headers: { 'X-API-Key': apiKey },
  body: JSON.stringify({ email, smtp: true }),
});

if (response.status === 402) {
  // Solde insuffisant — valider sans SMTP ou recharger
  return validateWithoutSmtp(email);
}