Écosystème — Earn paths & Internal circulation

Statut d'implémentation (2026-10-02). Ce document décrit un modèle cible, pas ce que la plateforme fait. Ce que le code fait aujourd'hui : frais marketplace vendeur 3 % (BOOSTECOM_MARKETPLACE_FEE_RATE, src/types/marketplace.ts), parrainage 30 % sur 12 factures versé en argent sans minimum (affiliate.md), boutiques illimitées sur les plans payants (ADR 0037), add-on boutique retiré. Non implémentés : take rate marketplace 25 %, split agents/workflows 80/20, bounty 70/30, cash-out 75 $ et minimum vendeur 50 $, Partner tier 35 % sur 6 mois, commission sur achats de crédits (10 % ou 15 %), remise de 10 % sur le premier mois d'un filleul. Les lignes concernées ci-dessous sont marquées « non implémenté » ou « historique ».

Tous les flux user-to-user (marketplace, agent runs, affiliate) avec leurs take rates, payouts, et anti-fraud associés.

Règle d'or : aucune distribution n'est financée hors revenue déjà encaissé. BoostEcom n'avance jamais d'argent.

Insight clé v3.0 : au lancement (M0-M9), BoostEcom est SELLER + PLATFORM. Tous les items du marketplace sont nos propres produits → 100% marge sur cette ligne. Ce n'est qu'à M9+ que les sellers tiers ouvrent et qu'on bascule en take rate 25% (creator-friendly). Free users peuvent acheter sur le marketplace dès J0 (revenue path sans sub).

Marketplace

Take rate

M0-M9 : 100% marge (BoostEcom = seller + platform, propres produits) M9+ : 25% take rate (cible, non implémentée ; le code facture 3 % au vendeur) sur transactions de sellers tiers. Creator-friendly (vs App Store 30%, Shopify Theme Store 20%). Baissé de 30% à 25% en v3.0 pour attirer les top creators et compenser l'absence de network effect au launch.

Items vendables

Modes de pricing (au choix du seller)

Économie circulaire

User A paie 100$ en crédits → Item B
                          │
                          ├─ 75$ crédits → Seller balance (CIBLE 75/25, non implémentée : le code verse le vendeur en argent via Stripe Connect, frais 3 %)
                          │
                          └─ 25$ → BoostEcom (pure margin)

Seller peut :
  → Réutiliser sur la plateforme (zero cash outflow pour BoostEcom)
  → Cash out via Stripe Connect (cible, non implémentée sous cette forme)

Note v3.0 : marketplace M9+ take rate = 25% (vs 30% v2.0). Agent/workflow runs split = 80/20 (vs 75/25 v2.0). Voir tables détaillées plus bas.

Plus la circulation interne est forte, plus la marge BoostEcom est protégée.

Roadmap d'activation

Anti-fraud

Conditions de vente

• Seller minimum payout cash : $50 non implémenté (aucun minimum dans le code)
• Stripe Connect Express requis (KYC géré par Stripe)
• 1099-K auto pour US sellers > $600/an
• VAT EU géré par Stripe Tax sur le checkout
• Refund buyer : 7 jours money-back si seller flagué fraude

Agent / Workflow Runs

Mécanique différenciante vs Claude / ChatGPT (qui ne partagent pas leurs agents).

Modèle économique

User A configure un agent custom "@SEO-Expert"
  → publie sur le marketplace
  → autres users peuvent :
    a) Subscribe à l'agent ($X/mo)
    b) Pay per run ($X par exécution)

Split cible, **non implémenté** : **80% creator / 20% BoostEcom** (creator-friendly, attire les top devs vs Shopify Theme Store post-$1000 80/20)

Tracking technique

• Chaque run consomme des crédits côté caller
• Le caller paie le creator + AI Gateway
• Internal accounting : AgentRun(creatorId, callerId, agentId, creditsCost, timestamp)
• Payout creator agrégé hebdomadaire

Anti-fraud

• Self-runs detection : creator ne peut pas faire tourner ses propres agents pour gonfler les stats
• Sock puppet : détection orgId/userId/IP + Stripe Radar
• Volume anormal : alerte si run rate > 100x la moyenne du creator

Pricing recommandé creator-side (suggestions UI)

L'UI suggère des prix au creator :

Creator peut override mais BoostEcom affiche un signal "below market" si trop bas.

Affiliate Program

Termes et implementation : affiliate.md. Cette section garde le contexte ecosysteme (caps, anti-fraude, filleul) ; les chiffres font autorite la-bas, derives de src/config/affiliate.ts et verifies par pnpm docs:claims.

Commission

Pourquoi 30% et plus 25%. Cette table a dit 25% jusqu'au 30 aout 2026 pendant que /pricing et /network/referral vendaient 30% en ligne. Trois chiffres pour un produit, dont deux publies. La promesse publique gagne : c'est celle qu'un prospect a lue avant d'acheter. La duree, elle, etait deja la bonne des deux cotes.

Filleul (referred user)

Cap & validation manuelle

Stripe Connect

• Express accounts pour les affiliés, les memes que ceux du marketplace (StripeConnectAccount, onboarding sur /account/settings/payouts)
• KYC géré par Stripe
• Cron affiliate-payouts quotidien : chaque commission part 30 jours apres sa facture, ce qui donne un rythme mensuel a un abonne mensuel
• Aucun minimum de versement. /network/referral promet publiquement « no minimum threshold » ; cette page a dit $50 jusqu'au 30 aout 2026

Schéma DB existant

Les tables sont déjà en place :

• AffiliateCode(code, affiliateId, creditAmount, affiliateCommission, maxUses, validUntil, status)
• AffiliateRedemption(codeId, code, userId, orgId, creditsAwarded, affiliateCommissionEarned) avec @@unique([codeId, userId]) (idempotency)

Ajouté par billing/0119 :

• AffiliateCommission(affiliateId, codeId, orgId, stripeInvoiceId, netAmount, amount, termIndex, status, clawbackApplied) — le ledger, idempotent sur stripeInvoiceId
• Webhook commission → ledger (invoice.paid, charge.refunded, charge.dispute.created)
• Dashboard affilié (/account/settings/referrals), detail par filleul gate sur le plan
• Cron payout (affiliate-payouts)

Reste à coder :

• Capture ?ref= : l'attribution passe encore par la saisie du code
• Commission sur les achats de credits (ligne 10% ci-dessus)
• Caps et validation manuelle a $5000 / $10000 par mois

Bounty Program (M3+)

BoostEcom poste des tâches communautaires.

Catalogue

Paiement

• Choix contributor : crédits OU euros
• Crédits : ajout immédiat au compte
• Euros : Stripe Connect Express (KYC requis pour > $200)
• Audit trail : BountyPayout(taskId, contributorId, amount, currency, paidAt)

Funding

• BoostEcom finance directement (sur cash flow)
• À terme : community-funded (users boostent une bounty avec leurs crédits)

Activation

M3+ — quand la community a une masse critique. Pas avant.

Partner / Influencer Tier (M6+) : non implémenté

Pour les gros créateurs Shopify (10k+ followers, podcasts spécialisés, formateurs Shopify reconnus).

Conditions

Quote contre Partner Tier

Partner amène 50 conversions Pro × $79/mo (v4.0) = $3950/mo
  → Commission Partner: 35% × 6 mois = $1382.50/mois pendant 6 mois
  → Coût acquisition BoostEcom: $8295 par 50 conversions
  → CAC by partner: $165.90

vs referral standard (30% pendant 12 mois calendaires, cf. affiliate.md):
  → Commission: 30% × 12 mois = $1185/mois pendant 12 mois
  → Coût: $14220 sur 12 mois
  → CAC: $284.40 (plus élevé, mais durée longue)

Partner Tier est un raccourci d'acquisition à coût comparable, plus rapide à amortir.

Sponsored slots (M12+)

Pas activé au lancement. Liste exhaustive pour mémoire :

100% pure margin, no AI cost. Active quand audience justifie ($Xk MRR).

Récap des splits par flux

Code de référence