Liste de contrôle des paiements
Les points à vérifier avant d'ouvrir les ventes de votre wakapp en production.
GuideAdministrateurDéveloppeur
Passez cette liste en revue avant d'encaisser vos premiers clients réels. Chaque point correspond à une erreur constatée en intégration.
Compte et fiscalité
- Le compte Stripe connecté de votre organisation est au statut
ACTIVE, et non plusONBOARDING. - Votre compte Stripe est en mode production : les paiements de test ne sont pas acceptés en production.
- La checklist d'immatriculations TVA a été validée par Wakastart pour tous les pays où vous vendez.
- Si vous vendez à des particuliers dans plusieurs pays,
taxEnabledvauttruedans la configuration de facturation de l'application. - Le taux de commission effectif (
GET /api/pay/app-billing/context) correspond à celui convenu avec Wakastart.
Intégration
- Les sessions sont créées par votre serveur, à partir de vos propres tarifs ; le navigateur n'envoie jamais de montant.
- Les montants sont des entiers en centimes, hors taxes.
- Chaque commande a une
idempotencyKeystable, réutilisée telle quelle en cas de nouvelle tentative. -
successUrlcontient{CHECKOUT_SESSION_ID}, etsuccessUrlcommecancelUrlsont servies sur un hôte actif de votre application dans l'environnement de production. - La livraison n'intervient qu'après
GET /api/billing/checkout-sessions/{id}avecpaymentStatus: "paid", jamais sur la seule arrivée sursuccessUrl. - La page de retour sait traiter une session non payée (
paymentStatus: "unpaid") et une session introuvable (404). - Les métadonnées utiles au rapprochement (numéro de commande, identifiant client) sont dans
metadata: au plus 20 clés de 33 caractères au plus.
Exploitation
- Une personne de votre organisation sait appeler
POST /api/pay/app-billing/disable-salespour couper les ventes en urgence. - Les remboursements et les litiges sont traités depuis votre tableau de bord Stripe, et quelqu'un en est responsable.
- Vous avez prévenu Wakastart de tout changement de vos immatriculations TVA avant l'ouverture d'un nouveau pays.