Parcourir la documentation
Plans & credits

Crédits & mesure

Comment fonctionne le ledger de crédits, les deux garde-fous qui bloquent un dépassement, et pourquoi votre date de renouvellement n'est pas le premier du mois.

BoostEcom est un forfait mensuel fixe qui inclut des crédits. Il n'y a pas de facture au token à déchiffrer en fin de mois.

Les montants par palier vivent dans Plans & limites — délibérément à un seul endroit, pour qu'ils ne puissent jamais se contredire.

Le ledger

Les crédits forment un ledger en ajout seul, pas un compteur qu'on écrase. Chaque octroi et chaque consommation est une ligne. Votre solde est la somme, ce qui veut dire :

  • L'historique est auditable : vous pouvez toujours voir ce qui a consommé quoi.
  • Un bug peut ajouter une ligne de correction, jamais réécrire le passé en silence.
  • GET /api/usage lit le ledger en direct, pas un chiffre en cache.

Marge

L'usage des modèles est facturé à 1,5× le coût fournisseur sous-jacent sur les paliers payants, et à 1,0× sur Custom. Ce multiplicateur, c'est la marge, et elle est affichée plutôt que cachée dans une unité « crédit » opaque.

Les deux garde-fous

Les deux sont durs, et s'appliquent à tous les plans et tous les niveaux d'autonomie :

1. Estimation avant streaming. Avant qu'une requête ne tourne, son coût est estimé. Si l'estimation dépasse votre solde, la requête est refusée avec un 402 et rien n'est streamé. Vous n'êtes jamais facturé pour une requête qui allait de toute façon manquer de solde.

2. Plafond dur en cours de streaming. Une génération longue est mesurée pendant qu'elle tourne. Dès que le coût en cours atteint votre solde, le stream est interrompu. Une requête ne peut jamais faire passer votre solde en négatif.

Le renouvellement, c'est votre anniversaire, pas le 1er

Les crédits mensuels se réinitialisent le jour ancre de votre abonnement, le jour du mois où vous vous êtes abonné, pas le premier. Une boutique abonnée le 18 se rafraîchit le 18.

Le cron quotidien parcourt les organisations dont le jour ancre est aujourd'hui. Chaque octroi est idempotent : le cron, le webhook subscription.created et le filet de sécurité invoice.paid écrivent tous via la même clé, donc trois chemins vers les crédits du même mois ne les accordent qu'une fois.

Bonus quotidien

Les paliers payants accumulent un petit bonus quotidien en plus de l'allocation mensuelle. Il est par organisation, et il expire à minuit UTC sans s'accumuler. Les montants sont dans Plans & limites.

Taxe

Stripe Tax est actif au paiement (TVA UE et sales tax US). Quand vous achetez des crédits, l'octroi lit le montant hors taxe. Vous n'êtes jamais crédité pour la taxe que vous avez payée, et jamais lésé non plus.

Lire votre usage

| Surface | Ce qu'elle donne | |---|---| | GET /api/usage | Le ledger en direct de votre organisation. | | /<org>/~/billing | État de l'abonnement, factures, plan. | | /<org>/~/billing/activate | Après paiement : l'état réel de chaque webhook avant de rendre la main. |

Ce dernier point mérite d'être connu. Après un paiement, il affiche si le paiement, l'abonnement, le changement de plan et l'octroi de crédits ont chacun réellement abouti, plutôt que de faire tourner un minuteur en espérant.

Vous avez construit avec cette doc ?

Passez sur le forum si quelque chose n'est pas clair ou est faux. La doc s'améliore plus vite quand les lecteurs signalent les manques.

Ouvrir le forum