Aller au contenu

Activer les ventes

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

GuideAdministrateurDéveloppeur
Accès requis
Niveau Administrateur client, dans l'organisation qui édite l'application
Durée
15 min, hors délais de vérification Stripe
Voir en Markdown

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.

ChampValeursEffet
defaultCurrencyEUR ou USD, trois lettres majusculesDevise de toutes les sessions de l'application
taxEnabledtrue ou falseActive le calcul de la taxe par Stripe Tax au moment du paiement
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 }'
TypeScript
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.

Bash
curl -s -X POST https://api.wakastart.app/api/pay/app-billing/enable-sales \
  -H "Authorization: Bearer $WAKASTART_TOKEN"
TypeScript
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 : 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.

Voir aussi