Créer des abonnements est une capacité centrale dans Hyperline. Dans cet article, nous explorerons les différentes options disponibles pour les attribuer à vos clients, des besoins simples aux plus complexes. Avant de démarrer un abonnement, vous devez configurer les produits que vous souhaitez facturer et, éventuellement, créer des modèles pour simplifier le processus d’attribution d’abonnement, en utilisant des configurations packagées réutilisables.

Bien que les produits soient configurés au niveau du compte, vous pouvez personnaliser chaque option au niveau du client, vous permettant de les ajuster selon des besoins spécifiques au cas par cas sans impacter votre configuration globale.

Configurer un abonnement

Configurer un abonnement dans Hyperline ne prend que quelques clics. Cependant, nous offrons également la flexibilité de personnaliser les abonnements pour chaque client, vous offrant plus de polyvalence et d’agilité.

Depuis une page client, cliquez sur actions puis Assign new subscription

Vous pouvez également créer de nouveaux abonnements depuis la page de liste des abonnements. Dans ce cas, vous devrez sélectionner le client.

Optionnellement, sélectionnez un modèle préconfiguré

Vous pouvez démarrer un abonnement soit à partir d’un modèle préconfiguré, soit configurer votre abonnement manuellement à partir de zéro.

Sélectionner la durée de l'abonnement

Démarrage de l’abonnement

Dans le passé, si vous voulez rétroporter un abonnement qui a déjà démarré mais pas dans Hyperline, ou si vous voulez facturer un client en arrears — toute période passée due sera facturée.
Immédiatement, la valeur par défaut
Dans le futur, si vous voulez planifier un abonnement pour le futur
À la finalisation du checkout, une fois le checkout finalisé par votre client

Alignement de l’abonnementLes abonnements suivent un schéma de renouvellement prévisible basé sur leur date de début :

Si un abonnement commence au début standard d’une période de facturation (par ex., le 1er du mois pour les forfaits mensuels ou le 1er de l’année pour les forfaits annuels), il s’aligne automatiquement, et chaque nouvelle période commence à la même date fixe.
Si un abonnement commence à n’importe quel autre jour, il se renouvelle le même jour calendaire dans la période suivante (par ex., un abonnement commençant le 15 mars se renouvelle le 15 avril pour un forfait mensuel).

Gérer la configuration du contrat

Dans la configuration du contrat, nous vous permettons de configurer une durée de contrat en activant le bouton.

La durée de contrat remplace la notion d’engagement qui a été dépréciée. Plus d’informations ici

Ajouter des produits à l'abonnement

Lors de l’ajout de produits en dehors d’un modèle, après avoir sélectionné le produit, la liste des prix définis dans votre catalogue de produits vous sera présentée. Elle est divisée en quelques sections :

Suggested : listera la meilleure tarification selon divers paramètres de l’abonnement : le pays du client, sa devise, la durée d’engagement.
Others : listera le reste des prix disponibles pour le produit.
Manual configuration : Si aucune correspondance n’est trouvée ou si vous ne trouvez pas le bon prix, vous pouvez sélectionner « Manual configuration » et passer à l’étape suivante où vous pourrez saisir le prix et la fréquence vous-même.

Une fois la configuration tarifaire sélectionnée, vous pouvez modifier les détails du produit. Lors de la modification d’une configuration de produit, cela n’impactera pas votre catalogue et n’aura d’effet que sur l’abonnement que vous êtes en train de créer. Cela vous donne la flexibilité de définir des tarifs spécifiques au client.

Vous pouvez ajuster la quantité directement depuis la vue principale de l’abonnement, ce qui facilite la personnalisation d’un abonnement, en particulier lors du démarrage à partir d’un modèle préconfiguré.

Optionnellement, ajouter des coupons

Vous avez également la possibilité d’attribuer des coupons à votre abonnement. Ces coupons peuvent être un montant fixe dans la devise du client, ou un pourcentage du prix du produit. Ils peuvent s’appliquer à des produits spécifiques ou à tous.

Une fois un coupon sélectionné, vous pourrez sélectionner :

La date d’application : choisissez si le coupon sera appliqué une fois, pour toujours ou pour une période personnalisée (faisant référence à la période durant laquelle les factures seront générées)
Les produits sur lesquels il sera appliqué (au moins un produit doit être sélectionné)

Optionnellement, ajouter un essai gratuit

Ajouter un essai gratuit vous permet de démarrer un abonnement sans facturer le client jusqu’à ce qu’une période spécifiée se soit écoulée. Dans Hyperline, un essai gratuit crée une nouvelle phase qui duplique la première phase, mais avec tous les produits définis comme gratuits.

Pour ajouter un essai gratuit, la première phase doit inclure au moins un produit.

L’essai gratuit est défini à 14 jours par défaut. Il peut se terminer après une durée personnalisée comme 14 jours ou 1 mois, à une date fixe ou avec une fin manuelle. L’essai gratuit peut être terminé plus tôt avec mark phase as finished.

Les détails de l’essai gratuit apparaîtront sur la page de paiement si l’abonnement est configuré pour démarrer après la finalisation du checkout.

Paramètres avancés

Date de facturation initiale

La date de facturation initiale est le moment où la période de facturation commencera. Elle est par défaut la date de début de l’abonnement, telle que définie dans le sélecteur subscription duration. Si l’abonnement commence à une date spécifique, la date de facturation peut être définie sur un jour personnalisé (qui est toujours après la date de début de l’abonnement).

Aligner la période de facturation sur le premier jour du cycle suivant

Activer l’option on permet de s’assurer que la prochaine période de facturation est alignée sur le premier jour du cycle de facturation suivant. Vous pouvez configurer cette option pour qu’elle soit activée par défaut dans Settings > Subscriptions.Par exemple, l’abonnement facturera la première période de facturation de la date de début (par ex., 14 janvier 2025) jusqu’à la fin du cycle actuel (par ex., 31 janvier 2025, lorsque le produit est facturé chaque mois). À partir du cycle suivant, la facturation suivra l’intervalle régulier (par ex., mensuel, du 1er février 2025 au 28 février 2025), garantissant l’alignement avec le calendrier de facturation standard.

Gérer les paramètres de facturation

Bon de commandeAjoutez un élément texte qui sera présent dans l’en-tête de chaque facture émise par cet abonnementGénérer des factures brouillonLa fonctionnalité de factures brouillon vous permet de vérifier une facture avant qu’elle ne soit envoyée. C’est pratique si vous devez vérifier ce qui est envoyé à votre client, ou lorsque vous testez la plateforme pour la première fois. Lorsqu’une facture est générée, elle sera définie comme brouillon que vous pourrez modifier, finaliser puis envoyer à votre client.Générer des documents au lieu de facturesLorsque Hyperline génère des documents au lieu de factures, les documents n’ont aucune valeur légale par rapport aux factures et peuvent être utilisés pour le reporting. Vous pouvez choisir d’ajouter la TVA au document ou non et définir un nom personnalisé pour le document.Ne pas facturer l’abonnementLes factures seront créées et la facture sera marquée comme payée, cependant, la plateforme ne facturera pas les factures. C’est pratique pour ajouter des abonnements à votre reporting lorsque le paiement est géré ailleurs.

Paiement de l’abonnement

Après avoir cliqué sur le bouton suivant Payment settings, vous devrez configurer la façon dont vous voulez que l’abonnement démarre et que votre client le paie. Vous pouvez également configurer les options de facturation comme étape optionnelle.

Moyens de paiement

Dans cette section, le moyen de paiement par défaut (celui qui sera utilisé pour facturer les factures) et les moyens de paiement autorisés (ceux que le client peut ajouter pendant le checkout et sur son portail) vous sont présentés. Vous pouvez modifier le moyen de paiement par défaut du client et activer ou désactiver ceux autorisés. Ces modifications seront appliquées au niveau du client.

Session de checkout

Hyperline fournit une page de paiement hébergée pour vos clients, leur permettant de saisir leurs informations de facturation (coordonnées, adresse) et d’ajouter le moyen de paiement qu’ils souhaitent utiliser pour les paiements d’abonnement récurrents. Cette page est à usage unique et est fournie au début du processus d’abonnement pour permettre à votre client de compléter l’acte de souscription à votre service.

L’utilisation de cette page est optionnelle, et peut être désactivée en désactivant Generate checkout session dans les paramètres globaux sous la section Subscriptions.

De plus, nous vous offrons un moyen d’ajouter une adresse email afin que Hyperline puisse envoyer automatiquement le lien de la page de paiement associée à votre client, sans aucune action de votre part.

Activation

L’activation de l’abonnement est désormais gérée dans l’étape précédente, étant maintenant alignée avec la stratégie de démarrage de l’abonnement (signature du devis, finalisation du checkout, manuellement ou à une date dite).

Attribuer l’abonnement

Lorsque tout est prêt à fonctionner, vous pouvez cliquer sur Assign subscription. Si le client sera facturé immédiatement, un message vous sera rappelé pour vous empêcher de le facturer involontairement.

Utiliser l’API

Si vous souhaitez une intégration technique plus poussée pour démarrer des abonnements sans action manuelle dans le produit, vous pouvez utiliser le endpoint create subscription.

POST /v2/subscriptions

De plus, vous pouvez récupérer les détails de l’abonnement en utilisant le endpoint get subscription, ou tous les lister en utilisant le endpoint list subscriptions.

Créer un abonnement à partir d’un modèle

Dans cet exemple, nous créons un nouvel abonnement à partir du modèle subt_7gdusOkqr5L0B8 pour le client cus_3PYD5R2q5NFK5E.

curl --request POST \
  --url https://api.hyperline.co/v2/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "customer_id": "cus_3PYD5R2q5NFK5E",
    "template_id": "subt_7gdusOkqr5L0B8"
  }'

Créer un abonnement à partir d’une liste de produits

Dans cet exemple, nous créons un nouvel abonnement avec deux produits payés tous les mois pour le client cus_3PYD5R2q5NFK5E, avec une date de début au 12 décembre 2025 et activé automatiquement à la date de début. Les prix des produits seront automatiquement déterminés en fonction des prix configurés dans le catalogue de produits pour la devise, l’intervalle, etc. correspondants.

curl --request POST \
  --url https://api.hyperline.co/v2/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "customer_id": "cus_3PYD5R2q5NFK5E",
    "starts_at": "2025-12-20T00:00:00Z",
    "activation_strategy": "start_date",
    "payment_method_strategy": "current",
    "products": [
      {
        "id": "itm_4vea8Gj0a5HZr9",
        "payment_interval": { "period": "months" },
      },
      {
        "id": "itm_vBBCZSTR6NzzuL",
        "payment_interval": { "period": "months" },
        "count": 2,
      },
    ]
  }'

Ici, le produit itm_4vea8Gj0a5HZr9 est un produit fee et itm_vBBCZSTR6NzzuL un produit seat avec 2 éléments appliqués.

Remplacer les prix

Lors de la création d’un abonnement, vous pouvez remplacer le prix d’un produit spécifique par un montant personnalisé. Notez que cette opération n’est autorisée que pour les produits flat_fee. Si nous reprenons notre exemple précédent et l’ajustons :

curl --request POST \
  --url https://api.hyperline.co/v2/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "customer_id": "cus_3PYD5R2q5NFK5E",
    "starts_at": "2023-12-20T00:00:00Z",
    "activation_strategy": "start_date",
    "payment_method_strategy": "current",
    "products": [
      {
        "id": "itm_4vea8Gj0a5HZr9", # flat_fee product
        "payment_interval": { "period": "months" },
        "price": { type: "fee", amount: 1234 }, # override
      },
      {
        "id": "itm_vBBCZSTR6NzzuL",
        "payment_interval": { "period": "months" },
        "count": 2,
      },
    ]
  }'

​Configurer un abonnement

​Paiement de l’abonnement

​Moyens de paiement

​Session de checkout

​Activation

​Attribuer l’abonnement

​Utiliser l’API

​Créer un abonnement à partir d’un modèle

​Créer un abonnement à partir d’une liste de produits

​Remplacer les prix

Configurer un abonnement

Paiement de l’abonnement

Moyens de paiement

Session de checkout

Activation

Attribuer l’abonnement

Utiliser l’API

Créer un abonnement à partir d’un modèle

Créer un abonnement à partir d’une liste de produits

Remplacer les prix