Démarrer un abonnement d'annonce (Admin)
Pour le personnel et les administrateurs HiLucy. Cette page est réservée aux administrateurs. Elle existe pour que nous puissions démarrer l'abonnement d'un propriétaire et enregistrer sa carte pendant que nous conduisons le processus, lorsque le propriétaire est au téléphone, en plein assistant, ou bloqué par un souci de connexion, sans attendre qu'il fasse tout lui-même via
/subscribe.
La page Abonnement est la contrepartie côté opérateur du parcours d'abonnement client. Tout se pré-remplit à partir de l'annonce, si bien que vous confirmez et collectez une carte, sans ressaisir de données. Ouvrez-la en mettant une annonce en contexte et en choisissant Abonnement sous le groupe Argent, ce qui mène à /admin/listings/<id>/subscription.
Ce qu'elle pré-remplit
Rien n'est redemandé. La page lit l'annonce pour renseigner :
- Propriétaire — le compte propriétaire revendiqué que l'abonnement facture. Si l'annonce n'a pas de propriétaire revendiqué, vous ne pouvez pas démarrer d'abonnement ; faites d'abord revendiquer l'annonce par le propriétaire.
- Forfait — Hôtel ou Location saisonnière, selon le type d'annonce.
- Chambres (hôtel uniquement) — le nombre de chambres facturables, issu d'abord des types de chambres publiés, puis du total d'onboarding.
- Aperçu du prix — le tarif de base plus, pour les hôtels, chambres × frais par chambre, avec le total mensuel après la période d'essai.
Les trois phases
1. Vérification
Confirmez le propriétaire, le forfait et le nombre de chambres. Pour un hôtel, vous pouvez ajuster le champ Chambres à la hausse ou à la baisse ; le total se recalcule en direct. La ligne de prix se lit comme base + chambres × frais par chambre, selon la même formule que celle du parcours en libre-service.
Quand vous êtes prêt, cliquez sur Démarrer l'essai de [30] jours et enregistrer la carte. Cela crée l'abonnement en période d'essai en coulisses et renvoie un secret de configuration Stripe pour que vous puissiez collecter la carte.
2. Carte enregistrée (Stripe SetupIntent)
Le formulaire de carte utilise Stripe Elements. La carte du propriétaire va du navigateur directement à Stripe, de sorte que les numéros de carte ne touchent jamais les serveurs de HiLucy ; seuls les identifiants de moyen de paiement et de configuration de Stripe transitent. Saisissez la carte et cliquez sur Enregistrer la carte et activer.
Rien n'est débité aujourd'hui. Comme l'indique le formulaire, la carte va directement à Stripe et est facturée automatiquement à la fin de la période d'essai de 30 jours. Derrière ce bouton unique, HiLucy rattache la carte confirmée comme moyen de paiement par défaut du propriétaire, puis active l'annonce (sauf si elle est déjà en ligne).
3. Terminé
Vous arrivez sur une confirmation : abonnement actif, carte enregistrée, propriétaire en essai de 30 jours, avec le premier prélèvement mensuel affiché. Si l'annonce avait déjà un abonnement, la page affiche sa carte de statut plutôt que le parcours de démarrage. Un propriétaire ne peut avoir qu'un seul abonnement actif, donc en démarrer un second est refusé.
Gestion de l'essai
Chaque démarrage crée un essai de 30 jours. L'essai commence maintenant et la carte est facturée à sa fin. Comme le parcours admin est une fine surcouche du même parcours que celui qu'utilise le propriétaire lorsqu'il s'abonne lui-même, les mécaniques d'essai, les webhooks de facturation et l'e-mail de bienvenue sont identiques au libre-service. Il n'y a aucun comportement de facturation propre à l'admin à prendre en compte.
Garder l'annonce gratuite
Certaines annonces devraient être mises en ligne sans facturation (un pilote, une gratuité, un ami de la maison). Sur l'écran de vérification, lorsque l'annonce n'est pas encore en ligne, un second bouton apparaît :
- Activer gratuitement — sans facturation. L'annonce est mise en ligne sans abonnement. Rien n'est facturé tant que vous ne choisissez pas d'en démarrer un, et elle peut rester gratuite indéfiniment.
Vous pouvez démarrer la facturation plus tard, à tout moment, depuis cette même page. Si une annonce est déjà en ligne gratuitement, l'écran de vérification l'indique et propose simplement de démarrer un abonnement quand vous le souhaitez.
Activation idempotente
L'activation n'est pas relancée à l'aveugle. Elle retransfère la propriété, redéclenche les hooks d'onboarding et renvoie l'e-mail de bienvenue, si bien que la relancer sur une annonce en ligne serait perturbateur. HiLucy s'en prémunit : si l'annonce est déjà en ligne et détenue par ce propriétaire, l'étape d'activation court-circuite vers un succès sans effet plutôt que d'écraser l'état en ligne. C'est ce qui rend sûr d'enregistrer une carte sur une annonce en ligne et gratuite depuis des mois : vous ajoutez la facturation, vous ne réactivez rien.
Piste d'audit
Comme cela déplace de l'argent depuis le côté opérateur, chaque démarrage, confirmation de carte et activation écrit une entrée au grand livre financier nommant l'administrateur qui l'a effectuée. La facturation pilotée par un administrateur est toujours attribuable.