# 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 »](#successurl-origin-not-allowed)
- [« Ce endpoint est réservé aux requêtes émises depuis une WakaApp »](#ce-endpoint-est-réservé-aux-requêtes-émises-depuis-une-wakaapp)
- [« Les ventes ne sont pas activées pour l'application … »](#les-ventes-ne-sont-pas-activées-pour-lapplication)
- [« … n'est pas encore apte à encaisser » ou « … est en statut RESTRICTED »](#le-compte-nest-pas-apte-à-encaisser)
- [« Aucun compte Stripe Connect pour le Customer … »](#aucun-compte-stripe-connect-pour-le-customer)
- [« La checklist d'immatriculations TVA … n'est pas validée »](#la-checklist-dimmatriculations-tva-nest-pas-validée)
- [Une nouvelle tentative a renvoyé une erreur Stripe](#une-nouvelle-tentative-a-renvoyé-une-erreur-stripe)
- [La confirmation répond 404](#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** :
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](/v1.0/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](/v1.0/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](/v1.0/paiements/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.
