Activation des ventes
Les quatre conditions qu'une application doit remplir avant d'encaisser, et les statuts du compte Stripe connecté.
Une application ne peut pas encaisser tant que ses ventes ne sont pas ouvertes. Wakastart tient ce verrou fermé par défaut et ne l'ouvre que lorsque quatre conditions sont réunies. Cette page décrit ces conditions ; le guide Activer les ventes donne les étapes.
Définition
L'activation des ventes est l'état d'une application dont la configuration de facturation porte salesEnabled: true. Tant que ce champ vaut false, toute création de session de paiement est refusée avec un 409. Le verrou se règle par application, alors que le compte Stripe et la déclaration de TVA se règlent par organisation.
Pourquoi ce verrou existe
Votre organisation reste responsable de sa fiscalité. Wakastart vérifie toutefois, avant la première vente, que vous avez déclaré vos immatriculations TVA et que Stripe vous autorise à encaisser. Le verrou évite qu'une application mise en ligne trop tôt n'encaisse sur un compte incomplet, avec des paiements à rembourser ensuite.
Les quatre conditions
| # | Condition | Portée | Qui la remplit |
|---|---|---|---|
| 1 | Un compte Stripe connecté existe pour votre organisation, et son inscription Stripe est terminée | Organisation | Wakastart crée le compte et vous transmet le lien d'inscription ; vous remplissez le formulaire Stripe |
| 2 | L'application a une configuration de facturation | Application | Un administrateur client de votre organisation, par l'API |
| 3 | La checklist d'immatriculations TVA est validée | Organisation | Wakastart, sur votre déclaration |
| 4 | Les ventes sont ouvertes | Application | Un administrateur client de votre organisation, par l'API |
L'ouverture (condition 4) vérifie à nouveau les conditions 1 à 3 au moment de l'appel : checklist TVA validée, compte apte à encaisser (chargesEnabled), statut du compte ni RESTRICTED ni DISABLED.
Statuts du compte Stripe connecté
Wakastart recalcule le statut à partir de ce que Stripe indique sur le compte.
| Statut | Signification | Peut-on vendre ? |
|---|---|---|
PENDING | Compte enregistré, inscription non commencée | Non |
ONBOARDING | Inscription en cours ; Stripe accepte déjà les paiements mais attend encore des informations | Oui, si les autres conditions sont remplies |
ACTIVE | Inscription terminée, paiements acceptés | Oui |
RESTRICTED | Informations transmises, mais Stripe n'accepte pas les paiements | Non |
DISABLED | Compte déconnecté de la plateforme | Non |
Quand le compte est déconnecté, ou quand la checklist TVA est invalidée, Wakastart ferme les ventes de toutes les applications de votre organisation.
Fermer les ventes
La fermeture est un coupe-circuit : elle ne demande aucune condition et prend effet immédiatement. Les sessions déjà payées restent consultables ; seules les nouvelles sessions sont refusées. Vous rouvrez ensuite les ventes par le même appel d'ouverture, qui revérifie les conditions.
Exemples
- Lancement d'une nouvelle wakapp : le compte Stripe de l'organisation est déjà actif pour une autre application. Seules les conditions 2 et 4 restent à remplir pour la nouvelle application.
- Ouverture d'un nouveau pays : votre organisation doit s'immatriculer à la TVA dans un nouvel État. Wakastart invalide la checklist le temps de la mise à jour ; toutes vos applications cessent de vendre jusqu'à la nouvelle validation.
- Incident de tarification : une erreur de prix est découverte un vendredi soir. Un appel de fermeture coupe les ventes de l'application concernée sans toucher aux autres.