# Activer les ventes

> Ouvrir votre compte Stripe, configurer la facturation de l'application, faire valider la TVA, puis ouvrir les ventes.

Avant le premier paiement, votre application doit avoir ses ventes ouvertes. Ce guide suit les quatre étapes dans l'ordre : deux se font avec l'équipe Wakastart, deux par l'API publique. Le concept [Activation des ventes](/v1.0/paiements/activation-des-ventes) explique pourquoi chacune est exigée.

## Avant de commencer

- Votre application existe sur Wakastart. Elle est créée par Wakastart ; contactez-nous pour en ouvrir une.
- Vous êtes Administrateur client de l'organisation qui édite l'application : c'est elle qui encaissera.
- Vous disposez d'un jeton d'accès émis **pour cette application**, au nom de ce compte administrateur. Les exemples l'utilisent en `Authorization: Bearer`. Voir [Authentification](/v1.0/authentification).
- Vous connaissez les pays dans lesquels votre entreprise est immatriculée à la TVA.

## Ouvrir votre compte Stripe

Cette étape se fait avec l'équipe Wakastart, une fois par organisation.

::::steps
### Demander l'ouverture du compte
Écrivez à votre contact Wakastart en indiquant l'organisation qui encaissera. Wakastart crée un compte Stripe connecté rattaché à cette organisation et vous transmet un lien d'inscription Stripe.

### Remplir l'inscription Stripe
Ouvrez le lien et suivez le formulaire hébergé par Stripe : identité de l'entreprise, représentant légal, coordonnées bancaires. Le lien est à usage unique ; s'il a expiré, demandez-en un nouveau.

### Revenir sur Wakastart
À la fin du formulaire, Stripe vous renvoie vers Wakastart, qui relit l'état du compte. Le compte passe au statut `ONBOARDING`, puis `ACTIVE` quand Stripe a vérifié vos informations.
::::

Résultat : votre organisation possède un compte Stripe connecté. Il servira pour toutes ses applications.

## Configurer la facturation de l'application

Cette étape crée la configuration de facturation de l'application. Elle échoue avec un `404` tant que le compte Stripe de l'étape précédente n'existe pas.

Envoyez `PUT /api/pay/app-billing` avec les champs à régler. Les champs absents gardent leur valeur ; à la création, la devise vaut `EUR` et la taxe automatique est désactivée.

| Champ | Valeurs | Effet |
|---|---|---|
| `defaultCurrency` | `EUR` ou `USD`, trois lettres majuscules | Devise de toutes les sessions de l'application |
| `taxEnabled` | `true` ou `false` | Active le calcul de la taxe par Stripe Tax au moment du paiement |

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl -s -X PUT https://api.wakastart.app/api/pay/app-billing \
  -H "Authorization: Bearer $WAKASTART_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "defaultCurrency": "EUR", "taxEnabled": true }'
```
:::
:::tab{label="TypeScript"}
```ts
const response = await fetch("https://api.wakastart.app/api/pay/app-billing", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WAKASTART_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ defaultCurrency: "EUR", taxEnabled: true }),
});
if (!response.ok) throw new Error(`Configuration refusée : ${response.status}`);
console.log(await response.json());
```
:::
::::

Réponse attendue :

```json
{
  "id": "5b0c8f7e-2d41-4b8a-9c1e-0f3a6d7e8b21",
  "appWid": "app123",
  "customerWid": "cus456",
  "applicationFeeBps": null,
  "defaultCurrency": "EUR",
  "prebillingEnabled": false,
  "taxEnabled": true,
  "portalConfigurationId": null,
  "salesEnabled": false,
  "createdAt": "2026-10-23T09:12:44.120Z",
  "updatedAt": "2026-10-23T09:12:44.120Z"
}
```

`applicationFeeBps: null` signifie que le taux de commission par défaut de la plateforme s'applique. Pour voir le taux effectif, appelez `GET /api/pay/app-billing/context` : le champ `applicationFeeBps` y contient la valeur réellement appliquée, par exemple `200`.

## Faire valider la checklist TVA

Cette étape se fait avec l'équipe Wakastart, une fois par organisation.

1. Transmettez à votre contact Wakastart la liste de vos immatriculations TVA par pays où vous vendez.
2. Attendez la confirmation : Wakastart enregistre la checklist comme complète, avec la date et l'auteur de la validation.

Résultat : la condition fiscale est remplie pour toutes les applications de votre organisation. Si vos immatriculations changent, prévenez Wakastart : l'invalidation de la checklist ferme les ventes de toutes vos applications jusqu'à la nouvelle validation.

## Ouvrir les ventes

Envoyez `POST /api/pay/app-billing/enable-sales`, sans corps.

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl -s -X POST https://api.wakastart.app/api/pay/app-billing/enable-sales \
  -H "Authorization: Bearer $WAKASTART_TOKEN"
```
:::
:::tab{label="TypeScript"}
```ts
const response = await fetch(
  "https://api.wakastart.app/api/pay/app-billing/enable-sales",
  { method: "POST", headers: { Authorization: `Bearer ${process.env.WAKASTART_TOKEN}` } },
);
const body = await response.json();
if (response.status === 409) throw new Error(`Condition manquante : ${body.message}`);
console.log(body.salesEnabled); // true
```
:::
::::

Réponse attendue (`201`) : la configuration complète, avec `"salesEnabled": true`.

Si une condition manque, l'API répond `409` et le message nomme la condition, par exemple :

```json
{
  "statusCode": 409,
  "message": "La checklist d'immatriculations TVA du Customer cus456 n'est pas validée",
  "error": "Conflict",
  "timestamp": "2026-10-23T09:15:02.311Z",
  "path": "/api/pay/app-billing/enable-sales"
}
```

## Fermer les ventes

Pour suspendre les ventes d'une application, envoyez `POST /api/pay/app-billing/disable-sales`. L'appel ne vérifie aucune condition et répond `201` avec `"salesEnabled": false`. Les nouvelles sessions sont refusées dès la réponse ; les paiements déjà réalisés ne sont pas touchés.

```bash
curl -s -X POST https://api.wakastart.app/api/pay/app-billing/disable-sales \
  -H "Authorization: Bearer $WAKASTART_TOKEN"
```

## Vérifier le résultat

Relisez la configuration :

```bash
curl -s https://api.wakastart.app/api/pay/app-billing \
  -H "Authorization: Bearer $WAKASTART_TOKEN"
```

Le champ `salesEnabled` vaut `true`. Créez ensuite une session de test en suivant [Encaisser un paiement](/v1.0/paiements/encaisser-un-paiement) : la réponse contient une `url` Stripe.

## Dépannage

- `404` « Aucun compte Stripe Connect pour le Customer … » : le compte de l'étape 1 n'existe pas encore, ou votre jeton appartient à une autre organisation que l'organisation éditrice.
- `409` « … n'est pas apte à encaisser » : Stripe attend encore des informations ; terminez l'inscription Stripe.
- Les autres cas sont dans [Résoudre les problèmes de paiement](/v1.0/paiements/depannage).

## Voir aussi

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