# Paiements

> Encaissez les clients de votre wakapp sur votre propre compte Stripe, avec Stripe Connect ; Wakastart prélève sa commission à la source.

Le module Paiements permet à votre [wakapp](/v1.0/glossaire#wakapp) de faire payer ses propres clients : achat ponctuel ou abonnement. L'argent arrive sur **votre** compte Stripe, et non sur celui de Wakastart. Wakastart prélève sa commission au moment du paiement, sans facture séparée.

Vous n'intégrez pas Stripe vous-même : votre serveur demande une session de paiement à l'API publique de Wakastart, puis redirige le client vers la page de paiement hébergée par Stripe.

## Comment ça marche

```mermaid
sequenceDiagram
  autonumber
  participant U as Client final
  participant S as Serveur de votre wakapp
  participant A as API Wakastart<br/>/api/billing
  participant P as Stripe Checkout<br/>(votre compte connecté)
  U->>S: Clique sur « Payer »
  S->>A: POST /api/billing/checkout-sessions
  A-->>S: id et url de la session
  S-->>U: Redirection vers url
  U->>P: Saisit sa carte et paie
  P-->>U: Retour sur successUrl?session_id=cs_…
  U->>S: Arrive sur la page de confirmation
  S->>A: GET /api/billing/checkout-sessions/{id}
  A-->>S: status complete, paymentStatus paid
```

1. Votre serveur construit la commande et appelle `POST /api/billing/checkout-sessions` avec le jeton du client connecté. Wakastart calcule le total et sa commission.
2. Le client paie sur la page Stripe. Le paiement est encaissé directement sur votre compte Stripe : c'est le modèle « Direct Charges » de Stripe Connect.
3. Au retour, votre serveur relit la session pour confirmer le paiement avant de livrer.

Le [modèle d'encaissement](/v1.0/paiements/modele-d-encaissement) détaille qui encaisse quoi, et comment la commission est calculée.

## Choisissez votre approche

::::cards{cols=2}
:::card{title="Encaisser avec Stripe Connect" href="/v1.0/paiements/activer-les-ventes" icon="CreditCard"}
Vous vendez depuis votre wakapp. Wakastart ouvre votre compte Stripe, calcule la commission et contrôle les conditions de vente. C'est la voie recommandée.
:::
:::card{title="Consulter un fournisseur existant" href="/v1.0/paiements/consulter-votre-fournisseur-de-paiement" icon="Receipt"}
Vous encaissez déjà avec Stripe, Paddle ou Polar. Vous enregistrez votre clé pour lire vos factures, achats et produits depuis l'API Wakastart. Rien n'est encaissé par Wakastart.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Comprendre le modèle" href="/v1.0/paiements/modele-d-encaissement" icon="BookOpen"}
Direct Charges, commission, rôle de chacun.
:::
:::card{title="Activer les ventes" href="/v1.0/paiements/activer-les-ventes" icon="ToggleRight"}
Les quatre étapes avant le premier paiement.
:::
:::card{title="Encaisser un paiement" href="/v1.0/paiements/encaisser-un-paiement" icon="ShoppingCart"}
Créer une session, rediriger, confirmer : exemples complets.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Paiement ponctuel" href="/v1.0/paiements/encaisser-un-paiement" icon="Banknote"}
Jusqu'à 100 lignes par commande, montants en centimes, page de paiement hébergée par Stripe.
:::
:::card{title="Abonnement" href="/v1.0/paiements/encaisser-un-paiement#encaisser-un-abonnement" icon="Repeat"}
Facturation quotidienne, hebdomadaire, mensuelle ou annuelle, avec la commission prélevée sur chaque échéance.
:::
:::card{title="TVA automatique" href="/v1.0/paiements/activer-les-ventes#configurer-la-facturation-de-lapplication" icon="Percent"}
Stripe Tax calcule la taxe au moment du paiement quand vous l'activez.
:::
:::card{title="Nouvelles tentatives sans doublon" href="/v1.0/paiements/encaisser-un-paiement#rejouer-une-requête-sans-doublon" icon="ShieldCheck"}
Une clé d'idempotence obligatoire garantit qu'une commande ne crée qu'une session.
:::
:::card{title="Coupe-circuit" href="/v1.0/paiements/activer-les-ventes#fermer-les-ventes" icon="Power"}
Fermez les ventes d'une application d'un seul appel, sans condition.
:::
:::card{title="Métadonnées de commande" href="/v1.0/paiements/reference#créer-une-session-de-paiement" icon="Tags"}
Rattachez jusqu'à 20 valeurs à la session et relisez-les au retour du client.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Crédits" href="/v1.0/credits" icon="Coins"}
Rechargez les crédits de votre organisation, eux aussi payés par Stripe.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Obtenez le jeton du client final qui autorise la création d'une session.
:::
:::card{title="Domaines et URLs" href="/v1.0/domaines-et-urls" icon="Globe"}
Les URL de retour doivent appartenir aux domaines de votre application.
:::
::::

## Ressources

- [Référence du module Paiements](/v1.0/paiements/reference)
- [Référence API : paiements](/v1.0/reference-api/paiements)
- [Liste de contrôle de mise en production](/v1.0/paiements/liste-de-controle)
- [Résoudre les problèmes de paiement](/v1.0/paiements/depannage)
- [Limites et quotas](/v1.0/limites)
