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.
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 »
- « Ce endpoint est réservé aux requêtes émises depuis une WakaApp »
- « Les ventes ne sont pas activées pour l'application … »
- « … n'est pas encore apte à encaisser » ou « … est en statut RESTRICTED »
- « Aucun compte Stripe Connect pour le Customer … »
- « La checklist d'immatriculations TVA … n'est pas validée »
- Une nouvelle tentative a renvoyé une erreur Stripe
- La confirmation répond 404
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 :
- Vérifiez l'environnement : un hôte de recette n'est pas accepté si l'hôte n'y est pas déclaré.
- Utilisez l'hôte exact de votre front, sans faute de frappe ni sous-domaine différent.
- 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 :
- Ouvrez votre tableau de bord Stripe et traitez les demandes en attente.
- Si le lien d'inscription a expiré, demandez-en un nouveau à votre contact Wakastart.
- 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
messagede la réponse ; - le champ
timestampde la réponse ; - l'identifiant de session
cs_…s'il existe, et laidempotencyKeyutilisée.
N'envoyez jamais de jeton, de clé API ou de numéro de carte.