Aller au contenu principal

L'architecture de la facturation

Comment l'argent circule entre vous, l'exploitant, vos clients — les organisations — et kuploy.app ; et où réside l'état de chaque niveau.

Trois niveaux​

   ┌─────────────────────────────────────────────────────┐
   │  Niveau 1 : exploitant → kuploy.app (Stripe)        │
   │  Vous payez kuploy.app pour la plateforme.          │
   │  L'offre fixe les plafonds cumulés et les           │
   │  fonctionnalités accordables à vos clients.         │
   └─────────────────────────────────────────────────────┘
                             ▲
                             │  La synchronisation de licence du niveau 1
                             │  fait descendre fonctionnalités et limites
                             ▼
   ┌─────────────────────────────────────────────────────┐
   │  Niveau 2 : organisation → vous (votre passerelle)  │
   │  Vos clients vous paient l'offre que vous           │
   │  définissez sur /admin/plans. L'abonnement de       │
   │  l'organisation est stocké dans votre propre base.  │
   │  Les gardes composent N1 × N2 : une organisation    │
   │  n'obtient une fonctionnalité que si votre niveau   │
   │  ET son offre l'accordent tous les deux.            │
   └─────────────────────────────────────────────────────┘
                             ▲
                             │
                             ▼
   ┌─────────────────────────────────────────────────────┐
   │  Niveau 3 : client → organisation (epay-gateway)    │
   │  Chaque organisation encaisse les règlements de     │
   │  ses propres clients par un compte marchand qui     │
   │  lui est propre sur l'epay-gateway (cinetpay,       │
   │  om-webpay, djomy…). Les fonds vont à la banque     │
   │  de l'organisation, pas à la vôtre.                 │
   └─────────────────────────────────────────────────────┘

Ce dont s'occupe kuploy.app (votre niveau 1)​

Lorsque vous vous inscrivez sur kuploy.app :

  • vous choisissez une offre de plateforme pour chaque produit que vous exploitez — les niveaux sont détaillés dans Les offres et les deux niveaux ;
  • kuploy.app prélève votre carte par Stripe, sur son propre compte Stripe ;
  • votre offre redescend vers votre déploiement dans la charge utile de la synchronisation de licence, qui contient des fonctionnalités (des capacités booléennes) et des limites (les quotas cumulés).

Changez d'offre de plateforme, dans un sens ou dans l'autre, sur kuploy.app/#pricing. Votre déploiement prend le changement en compte à la synchronisation de licence suivante — toutes les heures par défaut, ou immédiatement si vous en déclenchez une vous-même.

Ce dont s'occupe votre déploiement (votre niveau 2)​

  • Vos clients, les organisations, s'inscrivent directement sur votre déploiement.
  • C'est vous qui définissez les offres parmi lesquelles ils choisissent, sous /admin/plans : quotas, fonctionnalités, prix, devises. Voir Gérer vos offres.
  • Leurs paiements passent par ePay et se dénouent à votre compte marchand — voir Où l'argent atterrit.
  • La fonctionnalité que voit une organisation est l'intersection de votre niveau de plateforme (N1) et de son offre (N2). Accorder whitelabel: true sur une offre de niveau 2 alors que votre niveau de plateforme ne comprend pas la marque blanche est refusé dès la modification.

Ce dont s'occupent les clients de vos clients (niveau 3)​

  • Chaque organisation de votre déploiement peut brancher un compte marchand epay-gateway qui lui est propre (cinetpay, om-webpay, djomy).
  • Les règlements de ses factures vont directement à ce compte marchand : les fonds atterrissent à la banque de l'organisation, pas à la vôtre.
  • Vous ne voyez pas l'argent du niveau 3. Vous voyez seulement que vos organisations ont activé l'encaissement — un droit conditionné par votre niveau 1.

Où réside quoi​

Du côté de kuploy.app :

  • kuploy.app — l'identité, l'émission des licences, les catalogues d'offres de niveau 1, et le compte Stripe qui vous prélève.
  • Un abonnement par produit que vous achetez. Votre niveau kuploy-cloud et votre niveau leeram-business sont deux abonnements distincts sous le même compte : changer l'un laisse l'autre tranquille.

Du côté de votre déploiement :

  • L'état de la licence — rafraîchi depuis kuploy.app à chaque synchronisation. Il porte les fonctionnalités, les limites et le délai de grâce de votre niveau de plateforme.
  • Votre catalogue de niveau 2 — les offres que vous définissez sur /admin/plans. Il vous appartient : rien n'y est poussé d'en haut.
  • Les abonnements des organisations — sur laquelle de vos offres se trouve chaque organisation.
  • La garde des fonctionnalités — une organisation obtient une capacité seulement lorsque votre niveau 1 et son offre de niveau 2 l'accordent tous les deux.

Le niveau Internal​

Il existe une offre de niveau 2 particulière, nommée Internal, qui accorde toutes les fonctionnalités que permet votre niveau 1 et contourne entièrement la facturation de l'organisation. Servez-vous-en pour vos propres organisations, pour des comptes offerts, ou pour des relèvements temporaires pendant un incident d'assistance. Voir Gérer vos offres → Le niveau Internal.

Internal accorde jusqu'à — mais jamais au-delà de — votre plafond de niveau 1. Un exploitant sur l'offre Studio qui place une organisation sur Internal ne débloquera pas pour elle les fonctionnalités réservées à l'offre Agency.

Pour aller plus loin​