Aller au contenu principal

Paiements

Cette page explique comment les paiements sont créés dans Agon, comment connecter votre propre compte Stripe pour les paiements en ligne par carte, et où consulter les totaux des paiements.

Paiements n'est pas une page à part dans le menu latéral. Les réglages liés aux paiements se trouvent sous Paramètres → Facturation, et les totaux des paiements sous Rapports → Revenus.


Comment fonctionnent les paiements dans Agon​

Agon ne traite pas lui-même les paiements et n'a pas d'écran pour enregistrer manuellement un paiement ou un bouton de remboursement. Un Payment est créé automatiquement de deux façons :

  • Paiement via Stripe — une fois votre propre compte Stripe connecté (voir plus bas), un client peut payer en ligne un abonnement, ou une carte cadeau achetée pour lui-même, depuis l'application mobile. L'argent circule directement entre le client et votre compte bancaire ; Agon ne détient jamais les fonds.
  • Des frais d'annulation tardive ou d'absence — lorsqu'ils sont effectivement facturés (voir Paramètres — politique d'annulation et Abonnements — frais spécifiques), Agon les enregistre comme un Payment avec le fournisseur system.

Attribuer manuellement un abonnement à un client (voir Abonnements) ne crée pas de paiement — cela attribue uniquement l'abonnement. Si un client vous paie en espèces ou par virement, il n'existe actuellement aucun moyen d'enregistrer ce paiement dans Agon : vous attribuez simplement l'abonnement, exactement comme pour un essai gratuit.

Les ventes de produits en boutique sont suivies séparément (voir POS / Vente au détail) comme leur propre type d'enregistrement, pas comme des lignes Payment — elles apparaissent dans le rapport Ventes de Produits, pas dans les Revenus.


Connecter Stripe​

Agon propose deux façons de connecter votre propre compte Stripe. Pour la plupart des gestionnaires, Connect with Stripe est le choix le plus simple, puisque vous n'avez jamais à retrouver ou coller une clé API vous-même. Si vous avez déjà vos clés API Stripe, ou préférez ne pas utiliser le flux OAuth, vous pouvez les saisir manuellement — les deux parcours sont pleinement pris en charge.

Option A : Connect with Stripe (recommandé)​

  1. Allez dans Paramètres → Facturation.
  2. Cliquez sur Connect with Stripe.
  3. Votre navigateur ouvre la page d'autorisation hébergée par Stripe. Connectez-vous à votre compte Stripe existant, ou créez-en un, et autorisez Agon.
  4. Stripe vous redirige vers une courte page de confirmation hébergée par Agon. Fermez cet onglet et revenez sur Agon.
  5. Le statut Connexion Stripe dans Paramètres → Facturation passe à Connecté — automatiquement lorsque vous revenez sur la fenêtre Agon, ou après avoir cliqué sur Actualiser le statut.

Cela connecte directement votre propre compte Stripe — Agon ne détient jamais vos fonds, et aucun compte de plateforme partagé ne s'intercale entre vous et Stripe.

Option B : saisir vos clés API Stripe manuellement​

Utilisez ce parcours si vous avez déjà vos clés API Stripe sous la main, ou préférez ne pas utiliser le flux OAuth ci-dessus.

  1. Allez dans Paramètres → Facturation et ouvrez Options avancées.
  2. Saisissez votre Clé secrète et votre Clé publique, depuis votre propre tableau de bord Stripe (Developers → API keys).
  3. Cliquez sur Enregistrer.

Le statut Connexion Stripe passe à Connecté une fois des clés valides enregistrées.

Configurer le webhook​

Le champ Secret webhook est toujours visible dans Paramètres → Facturation — il n'est jamais caché dans les Options avancées — car Agon en a besoin pour savoir de façon fiable quand un paiement aboutit, quand un abonnement se renouvelle, échoue ou est annulé.

  • Si vous vous êtes connecté avec l'Option B (clés manuelles), Agon enregistre le webhook automatiquement pour vous. Il n'y a rien d'autre à faire.
  • Si vous vous êtes connecté avec l'Option A (Connect with Stripe), les restrictions propres à Stripe empêchent généralement Agon d'enregistrer le webhook automatiquement — c'est une limite de la plateforme Stripe, pas un manque d'Agon. Agon vous montre l'URL de webhook exacte à enregistrer, et vous devrez créer le webhook vous-même, une seule fois, dans votre propre tableau de bord Stripe — voir Configuration du webhook Stripe pour la marche à suivre exacte.

Si votre studio a un type d'abonnement récurrent actif mais aucun secret webhook enregistré, Agon affiche un avertissement dans Paramètres → Facturation, car la facturation récurrente n'a aucun autre moyen de détecter les renouvellements, échecs ou annulations.

Modifier ou retirer vos clés Stripe​

Il n'existe pas d'action séparée « Déconnecter Stripe ». Pour arrêter d'accepter les paiements Stripe, révoquez ou régénérez la clé depuis votre tableau de bord Stripe — les paiements des clients échoueront jusqu'à ce que vous enregistriez une nouvelle clé valide dans Paramètres → Facturation, ou remplacez celles que vous ne voulez plus utiliser.


Émettre un remboursement​

Agon n'a pas son propre bouton de remboursement :

  • Paiement Stripe — traitez le remboursement depuis votre tableau de bord Stripe. Agon reçoit le résultat au webhook suivant, qui met à jour le statut du paiement ici.
  • Espèces ou virement — rendez l'argent vous-même ; il n'y a rien à mettre à jour dans Agon dans les deux cas, puisque ce paiement n'y a jamais été enregistré.

Statuts de paiement​

StatutENITFRDEESPTNL
CompletedCompletedCompletatoComplétéAbgeschlossenCompletadoConcluídoVoltooid
RefundedRefundedRimborsatoRembourséErstattetReembolsadoReembolsadoTerugbetaald
FailedFailedFallitoÉchouéFehlgeschlagenFallidoFalhouMislukt

Consulter les totaux de paiements​

Allez dans Rapports → Revenus pour le revenu total, le nombre de paiements et le montant moyen sur une plage de dates. Il n'existe actuellement aucun écran listant l'historique des paiements d'un client en particulier. Les abonnements attribués manuellement et payés en espèces n'apparaissent pas non plus dans les Revenus, puisqu'ils ne créent jamais d'enregistrement Payment (voir ci-dessus).


Que faire si quelque chose ne fonctionne pas ?​

Un paiement Stripe s'affiche comme En attente Patientez quelques minutes — les webhooks Stripe peuvent être retardés. S'il est toujours en attente après 10 minutes, consultez votre tableau de bord Stripe, et vérifiez que le Secret webhook dans Paramètres → Facturation correspond bien à celui affiché dans Stripe.

La connexion Stripe apparaît comme Non connecté Allez dans Paramètres → Facturation et cliquez de nouveau sur Connect with Stripe, ou, si vous utilisez le parcours manuel, ressaisissez votre Clé secrète et votre Clé publique dans Options avancées.

Mes chiffres de Revenus semblent inférieurs à ce que j'ai réellement encaissé Vérifiez si certains abonnements ont été attribués manuellement plutôt que payés via un paiement Stripe — ceux-ci ne créent jamais d'enregistrement Payment, donc ils ne comptent pas dans les Revenus.

Pages associées​