Crédits & facturation

Cycle de vie des crédits

1. Création du premier token : 500 crédits gratuits sont attribués une seule fois, au moment de la première création de token.
2. Recharge mensuelle (plan gratuit) : le 1er de chaque mois à minuit UTC, 500 crédits sont automatiquement ajoutés à tous les tokens gratuits actifs.
3. Achat de crédits : les packs unitaires sont crédités immédiatement après le paiement Stripe.
4. Plans par abonnement : les crédits mensuels sont ajoutés à la réception de l'événement invoice.payment_succeeded Stripe — pas à la validation du checkout.
5. Rotation de token : créer un nouveau token révoque l'ancien et transfère le solde existant. Vous ne recevez pas un nouveau lot de 500 crédits.

Déduction avant exécution

Les crédits sont déduits avant l'exécution de chaque requête. Si votre solde est insuffisant, la requête est bloquée avec HTTP 402 (REST) ou un message d'erreur dans content[0].text (MCP).

Remboursement automatique

Si une requête échoue après déduction (erreur DB, timeout, 404), les crédits sont remboursés automatiquement. Cas de remboursement :

• Timeout ou erreur SQL inattendue
• GET /v1/transactions/:id — 404 transaction introuvable
• GET /v1/businesses/:siren — 404 SIRET introuvable

Indicateur de solde bas

Lorsque votre solde descend sous les 20 crédits, un champ note apparaît dans _credits :

"_credits": {
  "used": 5,
  "remaining": 12,
  "note": "Low credits! Recharge at normi.fr/dashboard/credits"
}

Coûts par outil