Plans
Le catalogue des plans de facturation, leurs prix et leurs quotas inclus. Public sur la page pricing, exposé aussi via l'API.
Vue d'ensemble
Plans est la source de vérité du pricing. Chaque plan a un nom, un prix mensuel et des quotas par ressource (tokens IA, minutes de transcription, conversations WhatsApp, emails). Les plans publics s'affichent sur la page pricing.
Les quotas pilotent l'usage. Un plan peut être en limite dure (l'usage se coupe au quota) ou souple. Le gating carte protège les routes IA et renvoie une bannière quand la facturation manque.
Le catalogue est lisible sans authentification via GET /v1/plans, exactement la même donnée que la page pricing marketing. Pratique pour un comparateur externe ou un site partenaire.
Ce que le module fait
Catalogue de plans
Les plans publics (is_public) sont ordonnés pour l'affichage. Chaque plan porte son prix mensuel en centimes et ses quotas inclus.
- Tokens Claude entrée et sortie
- Minutes de transcription, unités de compute
- Conversations WhatsApp, emails inclus
- Limite dure ou souple par plan
Quotas et entitlements
Chaque feature et chaque limite a une clé typée. Les entitlements se résolvent par plan, l'accès aux modules se vérifie côté serveur. Une feature au-dessus du plan déclenche un UpgradePrompt.
Gating carte
Les routes IA exigent une carte enregistrée. Sans facturation valide, la réponse est un 402 avec une bannière d'incitation, pas une erreur silencieuse.
API publique des plans
GET /v1/plans retourne le catalogue sans authentification. Premier endpoint public de l'API hors health, parce que la donnée est déjà publique sur le site.
Comment on l'utilise
- 01
Consulte le catalogue
La page pricing rend les plans publics, ou tu lis GET /v1/plans sans authentification.
- 02
Choisis un plan
À l'inscription ou dans l'onboarding, tu choisis ton plan avec sa carte associée.
- 03
Consomme dans tes quotas
L'usage IA, transcription et messages se décompte des quotas du plan.
- 04
Upgrade
Une feature au-dessus du plan ouvre un checkout d'upgrade, sans interruption.