Aller au contenu

Résoudre les problèmes de paiement

Les erreurs rencontrées en activant les ventes ou en créant une session de paiement, avec leur cause et leur correction.

DépannageAdministrateurDéveloppeur
Voir en Markdown

Cette page part du message que vous recevez. Les messages sont cités tels que l'API les renvoie ; l'identifiant entre guillemets est celui de votre application ou de votre organisation.

Symptômes

successUrl origin not allowed

Cause : l'hôte de successUrl (ou de cancelUrl, avec le message correspondant) n'est pas un nom d'hôte actif de votre application. Wakastart n'autorise un retour que vers les hôtes déclarés pour votre application, par exemple celui de votre front en production.

Solution :

  1. Vérifiez l'environnement : un hôte de recette n'est pas accepté si l'hôte n'y est pas déclaré.
  2. Utilisez l'hôte exact de votre front, sans faute de frappe ni sous-domaine différent.
  3. Si l'hôte est nouveau, déclarez-le d'abord sur votre application ; voir Domaines et URLs.

Pour vérifier : la même requête répond 201 avec une url Stripe.

Ce endpoint est réservé aux requêtes émises depuis une WakaApp

Cause : le jeton n'a pas été émis pour une application. C'est le cas d'un jeton de la console Wakastart ou d'un jeton obtenu pour une autre application.

Solution : utilisez le jeton de l'utilisateur connecté à votre wakapp, obtenu par sa connexion habituelle. Voir Authentification.

Les ventes ne sont pas activées pour l'application

Cause : salesEnabled vaut false : les ventes n'ont jamais été ouvertes, ou elles ont été fermées. Une invalidation de la checklist TVA ou une déconnexion du compte Stripe ferme les ventes de toutes les applications de l'organisation.

Solution : appelez POST /api/pay/app-billing/enable-sales. Si l'appel répond 409, corrigez la condition nommée dans le message.

Pour vérifier : GET /api/pay/app-billing renvoie "salesEnabled": true.

Le compte n'est pas apte à encaisser

Cause : Stripe n'accepte pas encore, ou plus, les paiements sur votre compte connecté. L'inscription Stripe est incomplète, ou Stripe a demandé des informations supplémentaires.

Solution :

  1. Ouvrez votre tableau de bord Stripe et traitez les demandes en attente.
  2. Si le lien d'inscription a expiré, demandez-en un nouveau à votre contact Wakastart.
  3. Rouvrez les ventes une fois le compte ACTIVE.

Aucun compte Stripe Connect pour le Customer

Cause : votre organisation n'a pas encore de compte Stripe connecté, ou votre jeton appartient à une autre organisation que celle qui édite l'application.

Solution : demandez l'ouverture du compte à Wakastart (première étape de Activer les ventes), puis rejouez l'appel avec un administrateur de l'organisation éditrice.

La checklist d'immatriculations TVA n'est pas validée

Cause : Wakastart n'a pas encore validé vos immatriculations TVA, ou les a invalidées après un changement.

Solution : transmettez vos immatriculations à votre contact Wakastart, attendez la validation, puis rouvrez les ventes.

Une nouvelle tentative a renvoyé une erreur Stripe

Cause : la requête rejouée réutilise une idempotencyKey déjà employée, avec un corps différent : lignes, montants ou URL ont changé.

Solution : pour rejouer, renvoyez exactement le même corps. Pour une commande modifiée, utilisez une nouvelle clé.

La confirmation répond 404

Cause : la session appartient à une autre application, ou à un autre client final que celui du jeton utilisé. Une faute dans l'identifiant cs_… donne le même résultat.

Solution : appelez la confirmation avec le jeton du client qui a payé, et l'identifiant reçu dans session_id sans le modifier.

Toujours bloqué ?

Écrivez au support Wakastart avec :

  • l'identifiant de votre application ;
  • la méthode, le chemin, le code HTTP et le champ message de la réponse ;
  • le champ timestamp de la réponse ;
  • l'identifiant de session cs_… s'il existe, et la idempotencyKey utilisée.

N'envoyez jamais de jeton, de clé API ou de numéro de carte.