# Modèle d'encaissement

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

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](/v1.0/glossaire#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.

```mermaid
flowchart LR
  F["Client final<br/>paie 69,00 €"] --> C["Votre compte Stripe connecté<br/>(Direct Charges)"]
  C -->|"commission retenue à la source<br/>2 % par défaut = 1,38 €"| W["Compte plateforme Wakastart"]
  C -->|"solde, après frais Stripe"| B["Votre compte bancaire"]
```

## 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](/v1.0/paiements/activation-des-ventes).

## Comment ça marche

### Qui fait quoi

| Acteur | Rôle |
|---|---|
| Votre organisation | Possède le compte Stripe connecté, configure la facturation de chaque application, ouvre et ferme ses ventes |
| Votre serveur | Construit la commande, crée la session de paiement avec le jeton du client final, confirme le paiement au retour |
| Le client final | Utilisateur connecté de votre wakapp ; il paie sur la page Stripe |
| Wakastart | Ouvre le compte connecté, valide la déclaration de TVA, calcule la commission, vérifie les URL de retour |
| Stripe | Hé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 vente | Calcul |
|---|---|
| Paiement ponctuel | sous-total × taux ÷ 10 000, arrondi au centime, plafonné au sous-total |
| Abonnement | pourcentage `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

- [Activation des ventes](/v1.0/paiements/activation-des-ventes)
- [Encaisser un paiement](/v1.0/paiements/encaisser-un-paiement)
- [Référence du module Paiements](/v1.0/paiements/reference)
