Paiements

Stripe avec 5 plans, 16 modules à la carte, 6 bundles, et système freemium.

Configuration Stripe

Variables d'environnement essentielles

# Clés API
STRIPE_SECRET_KEY="sk_test_xxxx"              # Serveur uniquement
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_xxxx"  # Client
STRIPE_WEBHOOK_SECRET="whsec_xxxx"            # Validation webhooks

Fichiers clés

Plans

HeartCo propose 5 plans avec une tarification EUR et CHF :

Tarification EUR

Réduction annuelle : ~20% sur tous les plans.

Tarification CHF (Suisse)

Utilisateurs supplémentaires

Période d'essai

• Durée : 14 jours
• Plan : Battement (BUSINESS) complet
• Carte bancaire : non requise
• À l'expiration : downgrade automatique vers FREE
• Crons : trial-expiry (downgrade) + trial-reminder (rappels à J-7 et J-2)

Modules à la carte

16 modules achetables individuellement, en complément du plan :

Modules inclus par plan

Bundles

6 packs thématiques regroupant plusieurs modules :

Quotas freemium

Chaque plan impose des limites d'utilisation. Le système "check before, increment after" vérifie les quotas avant chaque action.

Les quotas mensuels sont réinitialisés le 1er de chaque mois via le cron reset-usage.

Pattern "check before, increment after"

// Dans le router tRPC
const guard = await checkFreemiumLimit(ctx, "invoices");
if (!guard.allowed) {
  throw new TRPCError({
    code: "FORBIDDEN",
    message: `Quota factures atteint (${guard.used}/${guard.limit})`,
  });
}
 
// ... créer la facture ...
 
// Incrémenter APRÈS le succès (pas avant)
await ctx.db.subscription.update({
  where: { organizationId: ctx.session.user.organizationId },
  data: { invoicesUsed: { increment: 1 } },
});

Webhooks Stripe

Les webhooks Stripe sont gérés dans src/app/api/webhooks/stripe/. Événements principaux :

Modifier les plans

Changer un prix

1. Modifier dans src/lib/stripe-plan.ts :

PLAN_PRICING_EUR: {
  CORE: { monthly: 39, annual: 31 },  // Nouveau prix
}

2. Créer de nouveaux Price IDs dans le dashboard Stripe
3. Mettre à jour les variables d'environnement STRIPE_PRICE_*

Ajouter un module à la carte

1. Ajouter dans MODULE_PRICES_EUR de src/lib/stripe-plan.ts
2. Créer les Price IDs dans Stripe (monthly + annual)
3. Ajouter les env vars STRIPE_PRICE_MODULE_*
4. Ajouter dans STRIPE_PRICE_MAP

Changer les quotas freemium

Modifier PLAN_LIMITS dans src/lib/freemium/freemium-limits.ts. Utiliser -1 pour "illimité".

Fonctions utilitaires

import {
  getPlanFromPriceId,
  isModulePriceId,
  isBundlePriceId,
  isPlanPriceId,
  getPriceIdForCurrency,
} from "~/lib/stripe-plan";
 
// Identifier un Price ID
getPlanFromPriceId("price_xxx");        // "CORE" | null
isModulePriceId("price_xxx");           // true/false
isBundlePriceId("price_xxx");           // true/false
 
// Obtenir un Price ID par devise
getPriceIdForCurrency("CORE", "monthly", "EUR");  // "price_xxx"
getPriceIdForCurrency("CORE", "annual", "CHF");   // "price_yyy"