Crédits et facturation
Seule la vérification SMTP coûte un crédit. Tous les autres contrôles sont gratuits et sans quota.
La règle de facturation
Un crédit est débité si, et seulement si, les deux conditions sont réunies :
- le SMTP était activé pour l'appel (sur la clé API, la clé du widget, ou l'option du traitement par lots) ;
- le verdict final n'est pas unknown.
| Cas | Crédit |
|---|---|
| Clé sans SMTP | 0 |
| SMTP activé, verdict valid, risky ou invalid | 1 |
| SMTP activé, verdict invalid obtenu avant le dialogue (syntaxe fausse, domaine sans serveur) | 1 |
| SMTP activé, verdict unknown (accept-all, greylisting, délai dépassé) | 0 |
| SMTP activé, adresse noreply sans réponse concluante (verdict final risky) | 1 |
| Adresse en liste blanche ou noire | 0 (le SMTP n'est pas exécuté) |
Correction de faute vérifiée (typoCorrection) | 0 (sonde offerte) |
| Endpoints de suggestion et d'enrichissement | 0 |
| Connecteur : nettoyage de liste, nouveau contact ou contact vérifié à l'unité | Mêmes règles que ci-dessus (SMTP activé par défaut) |
| Assistant IA : validation à l'unité ou par lots | Mêmes règles que ci-dessus, selon le SMTP de la connexion |
| Assistant IA : recherche d'email BtoB | 0 (quota de 20 recherches par jour) |
Un verdict obtenu avant le dialogue SMTP est facturé parce que le résultat est définitif et exploitable : une adresse sans serveur de messagerie ne recevra jamais de courrier.
Plans
| Plan | Prix | Crédits SMTP |
|---|---|---|
| Free | 0 € | 100 crédits de bienvenue à l'inscription, une seule fois |
| Starter | 29 € HT / mois | 25 000 crédits par mois, non reportables d'un mois sur l'autre |
| Pro | 99 € HT / mois | 100 000 crédits par mois, non reportables d'un mois sur l'autre |
L'allocation mensuelle est créditée à chaque renouvellement de l'abonnement. Ce qui n'en a pas été consommé est perdu à l'échéance : il n'est pas ajouté à l'allocation suivante. Les crédits de packs, eux, ne sont jamais perdus.
Il n'y a aucune facturation au dépassement. Allocation épuisée : les appels avec SMTP reçoivent 402 jusqu'à ce que vous rechargiez avec un pack, utilisable aussitôt, ou que vous passiez du Starter au Pro. Les abonnements sont sans engagement : la résiliation prend effet à la fin de la période payée et peut être annulée jusque-là.
Changer de plan
Le changement de plan se fait depuis Crédits dans le tableau de bord.
| Sens | Prise d'effet | Facturation | Crédits |
|---|---|---|---|
| Starter → Pro | Immédiate : une nouvelle période mensuelle commence le jour même | Le Pro est facturé aussitôt, moins la part non utilisée du Starter sur la période en cours | Les 100 000 crédits du Pro remplacent le reste de l'allocation Starter dès le paiement confirmé |
| Pro → Starter | Au prochain renouvellement | Aucun remboursement ; le Starter est facturé au renouvellement | Vous gardez l'allocation Pro jusqu'à l'échéance, puis recevez 25 000 crédits par mois |
Si le paiement d'une montée n'aboutit pas (validation demandée par la banque, carte refusée), l'abonnement reste sur le Starter et aucun crédit Pro n'est ouvert. Les packs achetés ne sont jamais touchés par un changement de plan.
Packs de crédits
Achetables à tout moment depuis Crédits dans le tableau de bord, de 1 000 à 5 000 000 de crédits, avec un prix unitaire dégressif. Les crédits achetés n'expirent jamais.
Le catalogue à jour (plans, packs, prix HT) est public :
curl https://api.yeswecheck.fr/v2/billing/catalog
{
"currency": "eur",
"taxBehavior": "exclusive",
"plans": [
{ "code": "starter", "name": "Starter", "amountCents": 2900, "monthlyCredits": 25000, "unlimited": false, "purchasable": true },
{ "code": "pro", "name": "Pro", "amountCents": 9900, "monthlyCredits": 100000, "unlimited": false, "purchasable": true }
],
"packs": [
{ "name": "Pack 1 000 crédits", "credits": 1000, "priceCents": 500, "unitPriceCents": 0.5, "purchasable": true }
]
}
Extrait ; la réponse complète contient tous les plans et tous les packs.
Ordre de consommation
Votre solde peut réunir trois sortes de crédits. Ils sont consommés dans cet ordre, du plus périssable au plus durable :
| Ordre | Origine | Expiration |
|---|---|---|
| 1 | Allocation mensuelle de l'abonnement | Au renouvellement |
| 2 | Crédits offerts (bienvenue, geste commercial) | Selon le cas |
| 3 | Packs achetés | Jamais |
Vos crédits achetés ne sont donc jamais consommés tant qu'il reste de l'allocation du mois.
Suivre le solde
- Dans chaque réponse de validation avec SMTP :
metadata.credits.used(0 ou 1) etmetadata.credits.remaining(solde après l'appel). Sans SMTP,remainingvaut 0 : il n'est pas renseigné. - Dans le tableau de bord : solde, historique des mouvements, factures.
- Par alertes (Paramètres → Notifications), chacune réglable et désactivable : solde bientôt bas, solde bas, solde épuisé. Une alerte part une fois par épisode et se réarme quand le solde remonte.
Avec une clé API, GET /v2/me renvoie le solde de l'organisation et la consommation de la clé, sans débiter de crédit (module Get credit balance de l'app Make) ; un assistant IA le lit avec l'outil get_credits du serveur MCP.
Solde insuffisant : 402
Quand un SMTP est demandé et que le solde est à zéro, l'appel est refusé avant toute vérification :
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"statusCode": 402,
"message": "Insufficient credits for SMTP validation",
"code": "INSUFFICIENT_CREDITS",
"timestamp": "2026-10-15T09:12:44.512Z",
"path": "/v2/email/validate"
}
Testez code, pas message. Pour continuer à valider sans SMTP en attendant la recharge, gardez une seconde clé sans SMTP en secours.
429, pas 402Si le compte a du crédit mais que la clé a atteint son plafond journalier ou mensuel, la réponse est 429 API_KEY_BUDGET_EXCEEDED. Recharger n'y change rien. Voir Codes d'erreur.
En traitement par lots, un solde épuisé n'interrompt pas le job : les lignes restantes sont validées sans SMTP.
TVA, factures et remboursements
Voir la FAQ facturation.