Aller au contenu

Liste de contrôle des paiements

Les points à vérifier avant d'ouvrir les ventes de votre wakapp en production.

GuideAdministrateurDéveloppeur
Voir en Markdown

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 plus ONBOARDING.
  • 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, taxEnabled vaut true dans 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 idempotencyKey stable, réutilisée telle quelle en cas de nouvelle tentative.
  • successUrl contient {CHECKOUT_SESSION_ID}, et successUrl comme cancelUrl sont 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} avec paymentStatus: "paid", jamais sur la seule arrivée sur successUrl.
  • 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-sales pour 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.

Voir aussi