Aller au contenu

Modèle d'encaissement

Qui encaisse, qui porte la transaction et comment Wakastart calcule sa commission quand votre wakapp vend avec Stripe Connect.

ConceptAdministrateurDéveloppeur
Voir en Markdown

Quand votre wakapp vend, le paiement est encaissé sur le compte Stripe de votre organisation, et Wakastart prélève sa commission au passage. Cette page explique ce partage des rôles avant que vous ne branchiez la moindre ligne de code.

Définition

Le module Paiements repose sur Stripe Connect en mode Direct Charges. Votre organisation, le client Wakastart qui édite la wakapp, possède un compte Stripe « connecté » à la plateforme Wakastart. Chaque paiement de vos clients finaux est créé sur ce compte : c'est votre entreprise qui vend, qui apparaît sur le relevé bancaire du payeur et qui reçoit les fonds.

Le module n'est pas :

  • un compte Stripe partagé : chaque organisation éditrice a le sien, et deux applications d'une même organisation encaissent sur le même compte ;
  • un catalogue de produits : votre serveur décrit chaque commande ligne par ligne, avec ses montants ;
  • un outil de facturation de Wakastart vers vous : la commission est retenue à la source, sur chaque paiement.
Chargement du schéma…

Pourquoi ce modèle

Avec les Direct Charges, vous restez le vendeur. Vos clients paient votre entreprise, vos remboursements et vos litiges se traitent sur votre compte Stripe, et votre trésorerie ne transite jamais par Wakastart. Wakastart, de son côté, n'a pas à vous refacturer : sa commission est déduite au moment où le paiement est accepté.

La plateforme garde pourtant un contrôle : une application ne peut vendre que si son compte est en règle et si votre déclaration de TVA a été validée. C'est l'objet de l'activation des ventes.

Comment ça marche

Qui fait quoi

ActeurRôle
Votre organisationPossède le compte Stripe connecté, configure la facturation de chaque application, ouvre et ferme ses ventes
Votre serveurConstruit la commande, crée la session de paiement avec le jeton du client final, confirme le paiement au retour
Le client finalUtilisateur connecté de votre wakapp ; il paie sur la page Stripe
WakastartOuvre le compte connecté, valide la déclaration de TVA, calcule la commission, vérifie les URL de retour
StripeHéberge la page de paiement, encaisse, calcule la taxe si vous l'activez, verse les fonds

Le client final est toujours identifié

Une session de paiement se crée avec le jeton d'un utilisateur connecté à votre wakapp. Wakastart en déduit votre application et l'identité du payeur : votre serveur n'envoie jamais ces identifiants lui-même. Le jeton doit avoir été émis pour votre application, sinon l'API répond 403.

La commission

La commission s'exprime en points de base : 100 points de base valent 1 %. Le taux par défaut de la plateforme est de 200 points de base, soit 2 %. Un taux propre à votre application peut être convenu avec Wakastart ; il remplace alors le taux par défaut.

Type de venteCalcul
Paiement ponctuelsous-total × taux ÷ 10 000, arrondi au centime, plafonné au sous-total
Abonnementpourcentage taux ÷ 100 appliqué par Stripe à chaque facture de l'abonnement

Exemple : une commande de deux lignes à 49,00 € et 20,00 € donne un sous-total de 69,00 €, soit 6900 centimes. Au taux par défaut, la commission vaut 6900 × 200 ÷ 10000 = 138 centimes, soit 1,38 €.

Le sous-total est toujours recalculé par Wakastart à partir des lignes de la commande. Le taux appliqué est inscrit dans les métadonnées Stripe du paiement, pour vos rapprochements comptables.

Les frais Stripe et la taxe

Le paiement étant porté par votre compte, les frais de traitement Stripe, les remboursements et les litiges relèvent de votre compte Stripe, selon les conditions de Stripe. Les montants de chaque ligne s'expriment hors taxes. Si vous activez la taxe automatique, Stripe Tax la calcule au moment du paiement, à partir des immatriculations déclarées sur votre compte.

La devise

Chaque application a une devise de facturation, EUR par défaut. Toutes les lignes d'une session sont facturées dans cette devise : votre serveur ne la choisit pas commande par commande.

Exemples

  • Une plateforme de formation vend des modules à l'unité. Son serveur crée une session avec une ligne par module ajouté au panier ; le client paie une fois, la commission de 2 % est retenue sur le total.
  • Une application pour soignants propose une offre mensuelle à 19,00 € HT. Elle crée une session avec recurringInterval: "month" ; Stripe facture chaque mois, et la commission est prélevée sur chaque échéance.
  • Un éditeur avec deux wakapps encaisse les deux sur le même compte Stripe. Chaque application a sa propre configuration de facturation et peut être fermée à la vente indépendamment de l'autre.

Pour aller plus loin