Facturation de l'organisation et paramètres Stripe

Utilisez cette page lorsque vous avez besoin de connecter une organisation à Stripe, de confirmer que PrimeCal peut créer des sessions de paiement pour les réservations payantes, et de définir les paramètres de facturation par défaut utilisés par les nouveaux services payants.

Durée estimée : 10-15 minutes
Difficulté : Intermédiaire

Vue d'ensemble

La facturation de l'organisation est la couche réservée aux administrateurs qui se trouve derrière les réservations payantes. Elle contrôle :

• si l'organisation est connectée à Stripe Connect
• si les débits et virements sont actuellement utilisables
• la devise de facturation par défaut pour les nouveaux types de ressources payants
• si les types de réservation avec paiement requis peuvent réellement lancer une session Checkout

PrimeCal joue le rôle de plateforme. Chaque organisation connecte son propre compte Stripe et maintient sa propre relation de virement avec Stripe.

Prérequis

• Vous devez être administrateur de l'organisation.
• Votre organisation doit déjà exister et être sélectionnée comme organisation active.
• Vous avez besoin d'un compte Stripe capable de compléter l'intégration Stripe Connect.
• Pour les tests locaux ou en préproduction, votre environnement doit définir :
  • STRIPE_SECRET_KEY
  • STRIPE_WEBHOOK_SECRET
  • FRONTEND_URL
  • BACKEND_URL

Où trouver l'écran de facturation

PrimeCal expose la surface de facturation dans l'espace de travail des réservations :

• route principale : /app/reservations/billing
• route de retour Stripe : /settings/billing/stripe
• route de rafraîchissement Stripe : /settings/billing/stripe/refresh

Cet écran affiche :

• l'état de la connexion Stripe
• les débits, virements et la préparation à l'intégration
• la devise de facturation par défaut
• les actions de connexion, tableau de bord et déconnexion

Connecter Stripe pour une organisation

1. Basculez vers l'organisation active appropriée.
2. Ouvrez l'onglet Facturation dans l'espace de travail des réservations.
3. Consultez l'état Stripe actuel :
   • Non connecté
   • Intégration en cours
   • Connecté
   • Restreint
   • Désactivé
4. Sélectionnez Se connecter avec Stripe.
5. Complétez ou reprenez le flux d'intégration hébergé par Stripe.
6. Revenez dans PrimeCal et confirmez que l'état se met à jour.

Lorsque Stripe est connecté avec succès, PrimeCal stocke uniquement des métadonnées sécurisées au niveau du compte, telles que :

• stripeAccountId
• stripeConnectStatus
• la préparation aux débits et virements
• la devise par défaut de l'organisation

PrimeCal ne stocke pas les numéros de carte bruts, les codes CVV ni les coordonnées bancaires.

Configurer les paramètres de facturation par défaut

La section des paramètres de facturation par défaut permet aux administrateurs de définir la devise à trois lettres par défaut pour les nouveaux types de ressources payants.

Flux recommandé :

1. Vérifiez la devise de l'organisation déjà utilisée en opération.
2. Saisissez un code pris en charge par Stripe comme usd ou eur.
3. Enregistrez les paramètres de facturation.
4. Rouvrez un type de ressource payant et confirmez que la devise est préremplie comme prévu.

Les types de ressources peuvent toujours remplacer la valeur par défaut lorsqu'une devise prise en charge par Stripe est nécessaire pour un service spécifique.

Libellés de facturation localisés

L'écran de facturation est désormais entièrement localisé pour les langues prises en charge par l'application, au lieu de mélanger du contenu traduit avec de l'anglais codé en dur.

Paires de libellés importantes à valider :

Anglais	Hongrois
Billing and Stripe	Számlázás és Stripe
Connect with Stripe	Kapcsolódás a Stripe-hoz
Default billing currency	Alapértelmezett számlázási pénznem
Save billing settings	Számlázási beállítások mentése
Security notes	Biztonsági megjegyzések

Déconnecter Stripe

La déconnexion de Stripe est un arrêt opérationnel pour les nouvelles réservations avec paiement requis.

Lors de la déconnexion :

• PrimeCal efface la référence au compte Stripe stockée dans l'organisation
• les flux de réservation publique payante cessent de lancer des sessions Checkout
• les enregistrements existants côté Stripe restent dans Stripe pour les audits et le support
• les réservations gratuites continuent de fonctionner normalement

Utilisez la déconnexion lorsque vous devez suspendre la collecte de paiements ou faire passer l'organisation par un nouveau cycle d'intégration.

Sécurité et conformité

• Seuls les administrateurs de l'organisation peuvent gérer l'état de connexion Stripe ou les paramètres de facturation par défaut.
• Les types de réservation avec paiement requis doivent rester désactivés tant que Stripe ne signale pas une connexion utilisable.
• Les données de carte n'atteignent jamais les serveurs PrimeCal ; Stripe gère le formulaire de paiement et la collecte des données de carte.
• PrimeCal maintient l'isolation de l'organisation sur les routes de facturation. Le frontend lit l'identifiant de l'organisation depuis la route actuelle et le contexte authentifié, mais le backend reste la source de vérité.

Dépannage

L'écran de facturation indique que Stripe est connecté, mais les réservations payantes sont toujours bloquées

Ouvrez la section d'état et vérifiez :

• chargesEnabled
• payoutsEnabled
• detailsSubmitted
• currentlyDue
• disabledReason

L'organisation peut sembler connectée alors que Stripe exige encore une vérification supplémentaire avant que Checkout puisse être utilisé.

Je vois l'onglet Facturation, mais je ne peux pas enregistrer les modifications

Confirmez que votre rôle dans l'organisation est toujours admin. Les éditeurs peuvent gérer les ressources et les tarifs, mais les paramètres de facturation par défaut et les contrôles du cycle de vie Stripe restent réservés aux administrateurs.

La déconnexion a réussi, mais les anciennes réservations affichent toujours des identifiants Stripe

C'est le comportement attendu. La déconnexion affecte les futurs flux de paiement. Les références d'audit et de paiement des réservations existantes restent disponibles pour la réconciliation et le support.

Cibles des captures d'écran

Utilisez ces noms de fichiers pour que le guide utilisateur, le guide opérationnel et l'automation restent alignés.

État	Fichier	Objectif
Déconnecté	docs/assets/user-guide/enterprise-reservation-system/admin-stripe-disconnected-state.png	Montrer le point de départ de l'administrateur avant le début de l'intégration.
Connecté	docs/assets/user-guide/enterprise-reservation-system/admin-stripe-connected-state.png	Montrer une connexion Stripe saine avec les débits et virements visibles.
Paramètres de facturation	docs/assets/user-guide/enterprise-reservation-system/admin-billing-settings.png	Montrer le champ de devise de facturation par défaut et l'action d'enregistrement.

Consultez la séquence de capture complète dans docs/DEVELOPER-GUIDE/mcp-server/enterprise-reservation-screenshot-runbook.md.

Ressources associées

• Système de réservation d'entreprise pour les administrateurs d'organisation
• Réservations payantes
• API des organisations
• Stripe et réservations payantes pour les développeurs