Stripe
Mis à jour le 2026-08-28
Ce chapitre ne s’adresse pas à un salon de coiffure. Il décrit l’écran Stripe du panneau plateforme : la liaison par laquelle HairConnect encaisse l’abonnement mensuel auprès d’un salon.
Deux choses portent le nom « Stripe »
Ne les confondez pas : elles n’ont rien à voir l’une avec l’autre.
| Stripe du salon | Stripe de la plateforme | |
|---|---|---|
| Qui encaisse | le salon, auprès de ses propres clients | HairConnect, auprès du salon |
| Où cela se règle | dans le back-office du salon, sous Liaisons | sur l’écran Clés Stripe |
| Quel compte | celui du salon | celui de HairConnect |
| Quel écran | Liaisons | cet écran, et Clés Stripe à côté |
Ce chapitre ne traite que de la seconde. Si l’argent va vers le salon, vous n’êtes pas dans le bon chapitre.
Où le trouver ?
Sur /platform, dans la barre latérale sous Stripe. Seul un administrateur de la plateforme y accède.
Ce que l’écran montre
La liaison. En haut figure l’état de Stripe. S’il est indiqué Stripe est désactivé — rien n’est encaissé, c’est littéral : aucun salon n’est facturé. Le reste du logiciel continue de fonctionner — cela ne touche que la facturation de HairConnect elle-même, pas l’agenda ni la caisse d’un salon.
En dessous se trouve l’adresse à configurer chez Stripe comme point de terminaison webhook.
Paiement échoué. Les salons dont le prélèvement n’a pas abouti. Ils ne sont pas coupés : leur agenda et leur caisse continuent de tourner. C’est une liste d’appels, pas une sanction.
Webhooks. La date du dernier événement reçu de Stripe, le nombre reçu ces sept derniers jours, et en dessous la liste complète. Un point de terminaison muet depuis une semaine est aussi grave qu’un point de terminaison qui refuse — cela se remarque simplement moins, d’où la date en haut.
Activation
Les clés ne se trouvent pas sur cet écran mais sur Clés Stripe, juste à côté. C’est là que vous collez la clé API secrète et le secret du webhook, que vous testez la connexion, et que vous activez l’interrupteur principal. Aucun déploiement n’est nécessaire. Voir le chapitre Les clés Stripe.
L’adresse à configurer chez Stripe comme point de terminaison webhook figure ici comme là-bas.
Tant que rien n’est réglé, il ne se passe rien. Pas d’erreur, pas d’état intermédiaire : rien n’est créé chez Stripe et rien n’arrive. Sur le serveur de production, c’est différent — là, la liaison refuse bruyamment dès que quelqu’un tente d’activer un abonnement. Ne rien faire en silence y serait l’erreur la plus coûteuse : tout semblerait aller bien pendant des mois alors qu’aucun salon n’est encaissé.
Quels événements HairConnect traite
Activez au minimum ces trois événements sur le point de terminaison, dans le tableau de bord Stripe :
| Événement | Ce qui se passe |
|---|---|
invoice.paid (et invoice.payment_succeeded) |
Le mois est payé. Si le salon était en Paiement échoué, il repasse en Actif. Si la période est entre-temps écoulée, elle avance d’un mois. |
invoice.payment_failed |
Le salon passe en Paiement échoué. Il continue de fonctionner. |
customer.subscription.deleted |
L’abonnement a été résilié ou est arrivé à terme chez Stripe ; il est également résilié ici. Le mois en cours va à son terme. |
Tout le reste est conservé puis ignoré. La liste indique Ignoré, ce qui est autre chose que Refusé.
Refusé, ignoré, échoué
Trois mots qui se côtoient dans la liste et qui désignent trois choses différentes.
- Refusé — la requête n’a pas passé la porte. Signature invalide, ou aucun secret webhook configuré. Rien n’en a été fait. Ces enveloppes sont conservées afin de pouvoir vérifier qui a frappé, mais elles ne peuvent pas être traitées après coup non plus. C’est délibéré : une charge utile que personne n’a signée n’est pas une source de vérité.
- Ignoré — l’enveloppe était valide, il n’y a simplement rien à en faire.
- Échoué — le traitement s’est interrompu. Stripe représente l’événement de lui-même, et le bouton Retraiter permet aussi de le faire à la main. C’est sans risque : traiter deux fois le même événement n’a d’effet qu’une fois.
La période d’essai se déroule sans carte
Pendant l’essai, rien n’existe chez Stripe : ni client, ni abonnement, ni moyen de paiement. Les données de paiement ne sont demandées qu’à la fin de l’essai, lors de l’activation de l’abonnement.
Un salon mis gratuit manuellement contourne entièrement Stripe : aucun client n’est créé, aucun abonnement n’est ouvert, aucun paiement n’est tenté. Voir le chapitre Abonnements.
Ce que cet écran ne fait pas
Il ne crée pas de factures. Le numéro de facture et le traitement de la TVA proviennent de Fades ; cet écran ne fait qu’encaisser. Ce qui figure sur une facture ne se décide donc pas ici.