Activer les ventes
Ouvrir votre compte Stripe, configurer la facturation de l'application, faire valider la TVA, puis ouvrir les ventes.
- Accès requis
- Niveau Administrateur client, dans l'organisation qui édite l'application
- Durée
- 15 min, hors délais de vérification Stripe
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 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. - 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.
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 |
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 }'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 :
{
"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.
- Transmettez à votre contact Wakastart la liste de vos immatriculations TVA par pays où vous vendez.
- 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.
curl -s -X POST https://api.wakastart.app/api/pay/app-billing/enable-sales \
-H "Authorization: Bearer $WAKASTART_TOKEN"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); // trueRé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 :
{
"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.
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 :
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 : 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.