Hyperline CPQ ↔ Stripe Billing

Hyperline CPQ peut être intégré à Stripe Billing pour fournir à votre équipe commerciale une solution CPQ robuste, offrant à vos clients une expérience de contractualisation fluide tout en conservant votre configuration Stripe Billing existante. Bien que nous recommandions d’utiliser Hyperline comme plateforme de facturation complète — pour tirer parti de ses capacités avancées et réduire la complexité opérationnelle et les limitations des solutions de facturation externes — cette intégration vous permet toujours de créer et gérer des devis directement depuis Hyperline et votre CRM. Hyperline orchestrera automatiquement les abonnements associés dans Stripe Billing et traitera les paiements clients via Stripe Payments. Avec cette configuration, toutes les données et le suivi de l’activité de facturation peuvent être gérés dans Hyperline, entièrement synchronisés avec votre CRM, tout en continuant à utiliser Stripe Billing comme moteur de facturation existant et passerelle de paiement.

​

Comment ça marche

Hyperline fournit des intégrations puissantes avec Stripe et les CRM (HubSpot, Salesforce et Attio), ainsi qu’une solution CPQ complète. Les devis pour de nouveaux abonnements ou modifications d’abonnement (upsell, cross-sell, etc.) peuvent être créés directement depuis votre CRM en utilisant le widget intégré de Hyperline, dans l’interface Hyperline ou via l’API Hyperline. Une fois qu’un devis est approuvé et signé par votre client, Hyperline crée ou met à jour automatiquement l’abonnement dans Stripe Billing — sans intervention manuelle ni effort technique supplémentaire requis. Stripe Billing gère ensuite l’ensemble du cycle de vie de la facturation et du traitement des paiements. Tous les détails d’abonnement et les factures associées sont automatiquement synchronisés de Stripe vers Hyperline en temps réel, vous permettant de surveiller l’activité de facturation directement depuis Hyperline. Ces données sont également transmises à votre CRM, donnant à vos équipes opérationnelles et revenus une visibilité complète.

​

Prérequis

• Un compte Hyperline avec des droits d’administrateur
• Un compte Stripe avec des droits d’administrateur
• Les intégrations CPQ et Stripe activées dans Hyperline

​

Configuration

1. Allez dans la page Integrations de Hyperline
2. Cliquez sur « Connect » pour Stripe
3. Optionnellement, cliquez sur « Connect » pour Salesforce ou HubSpot

​

Importer le catalogue de produits Stripe

Une fois connecté, vous pouvez importer votre catalogue de produits et coupons Stripe dans Hyperline. Dans cette configuration, Stripe Billing reste la source de vérité pour la configuration de vos produits et coupons. Toutes ces données sont automatiquement répliquées et mappées sur les concepts et paramètres Hyperline (y compris les détails des produits et coupons, types de prix, variantes, paliers, configuration multi-devises, etc.).

1. Allez dans la page Products de Hyperline
2. Cliquez sur « Import from Stripe » dans le coin supérieur droit
3. Allez dans la page Coupons de Hyperline
4. Cliquez sur « Import from Stripe » dans le coin supérieur droit

Les modifications des produits et coupons doivent être effectuées dans Stripe. Toutes les modifications seront automatiquement synchronisées vers Hyperline.

​

Comportement fiscal

Par défaut, Hyperline ne prend en compte que les produits/prix avec un comportement fiscal « exclusif ». Tous les prix dans Hyperline sont considérés hors taxes dans le catalogue, les taxes étant ajoutées au niveau du devis/de la facture (selon les détails du client). Cela signifie que certains produits/prix Stripe pourraient ne pas apparaître dans Hyperline car ils sont ignorés par le système lors de l’import. Même si nous recommandons fortement d’utiliser des prix hors taxes par défaut, si vous traitez différents comportements fiscaux dans Stripe (inclusif ou non spécifié par exemple), vous devrez peut-être vérifier auprès de notre équipe de support la meilleure façon de gérer cela.

​

Archiver des produits

Bien que vous puissiez archiver ou supprimer des produits dans Stripe, Hyperline fournit également un moyen d’archiver les produits directement dans la plateforme. La différence clé est que l’archivage d’un produit dans Hyperline ne l’archive pas dans Stripe. Cela vous permet de découpler le statut du produit entre Stripe (pour vos besoins internes) et Hyperline. Un produit archivé dans Hyperline ne sera plus visible ou disponible lors de la création de nouveaux devis.

1. Allez dans la page Products de Hyperline
2. Cliquez sur le produit que vous souhaitez archiver
3. Cliquez sur le bouton « Actions » > « Archive »

​

Archiver des prix

De plus, selon la même logique, vous pouvez archiver un prix spécifique d’un produit. Le produit sera toujours disponible lors de la création de nouveaux devis, mais le prix archivé ne sera plus suggéré.

1. Allez dans la page Products de Hyperline
2. Cliquez sur le produit que vous souhaitez archiver
3. Sur la ligne de configuration du prix associé, cliquez sur le bouton « Archive »

​

Importer les clients Stripe

Après avoir importé vos produits et coupons, Hyperline vous permet d’importer vos clients existants. Avec cette action, Hyperline mappera automatiquement les clients Stripe dans Hyperline, ainsi que leurs moyens de paiement associés. Les nouveaux clients et les modifications des clients existants dans Stripe — y compris les ajouts ou suppressions de moyens de paiement — seront automatiquement synchronisés vers Hyperline en temps réel.

​

Importer les abonnements et factures Stripe

En utilisant la même logique que pour les clients, les historiques d’abonnements et de factures peuvent être importés depuis Stripe. Toutes les données d’abonnement seront mappées aux objets abonnement, phase, produit d’abonnement et coupon d’abonnement Hyperline, et les factures aux objets facture et ligne de facture Hyperline. Le suivi et le reporting dans Hyperline sont disponibles pour ces données, et vous pouvez également interroger les données historiques en utilisant l’API Hyperline. Les nouveaux abonnements, les détails de renouvellement d’abonnement, les détails de facture, les statuts et les PDF de factures seront automatiquement synchronisés vers Hyperline en temps réel.

​

Widget CRM

Si vous avez connecté votre CRM à Hyperline, les données clients associées (devis, abonnements, etc.) seront automatiquement affichées dans le widget CRM. Par conséquent, vous pouvez consulter les données d’abonnement et les factures Stripe dans votre CRM. En savoir plus sur la réconciliation des données. Ce widget peut être utilisé à la fois dans les objets Account/Company et Opportunity/Deal de votre CRM. L’objet Contact est également pris en charge dans HubSpot pour les cas d’usage et ventes B2C. En plus d’afficher les données, le widget permet aux utilisateurs du CRM de créer des devis directement depuis le CRM. Les interfaces de Hyperline sont intégrées afin que l’expérience Hyperline complète soit disponible sans quitter le CRM. Nous vous suggérons de suivre ces guides pour plus de détails :

• Carte HubSpot
• Composant Salesforce
• Actions Attio

​

Création de clients Hyperline

Lorsque le widget est chargé sur les pages CRM, le client associé dans Hyperline est recherché en utilisant la logique de réconciliation pour afficher les données correspondantes. Si aucune correspondance n’est trouvée, Hyperline créera un nouveau client. Pour empêcher les utilisateurs du CRM de créer un nouveau client Hyperline lorsqu’aucune correspondance n’est trouvée, vous pouvez désactiver l’option « Allow creating new customer » dans vos paramètres CRM Hyperline. Lorsqu’elle est désactivée et qu’aucune correspondance n’est trouvée, le widget affichera un message (par ex. « This company has no associated Hyperline customer. ») et aucune donnée ou action ne sera disponible. C’est particulièrement utile pour éviter de créer des doublons dans votre système de facturation ou pour s’assurer que le champ External ID dans votre CRM est rempli avant d’afficher le widget — et donc avant qu’un lien ne soit créé entre les clients CRM et Hyperline.

​

Créer un devis

Après la configuration (seul l’import des produits est requis), vous pouvez commencer à créer des devis directement depuis votre CRM ou Hyperline. Nous vous suggérons de suivre ces guides pour plus de détails :

• Créer et envoyer des devis
• Devis pour mise à jour d’abonnement
• En savoir plus sur la signature des devis
• Configurer des modèles de devis réutilisables

Une fois le devis signé, Hyperline appliquera automatiquement les modifications associées sur les abonnements de votre compte Stripe.

​

Automatisation post-signature

Par défaut, Hyperline crée ou met à jour automatiquement l’abonnement associé dans Stripe Billing une fois qu’un devis est signé. C’est le comportement recommandé, car il maintient les deux plateformes synchronisées sans aucun travail manuel. Pour les cas où vous préférez gérer l’abonnement Stripe vous-même — par exemple, lorsque le contrat nécessite une configuration Stripe spécifique qui ne peut être exprimée via le devis, ou lorsqu’un abonnement existant sera mis à jour manuellement — vous pouvez désactiver cette automatisation au cas par cas pour chaque devis. Lors de la configuration d’un devis, ouvrez la section Post-signature automation et désactivez Orchestrate Stripe Billing after signature. Une fois désactivée :

• Après la signature, aucun abonnement ne sera créé ou mis à jour dans Stripe par Hyperline.
• Un avis est affiché sur le devis pour rappeler à votre équipe que l’abonnement doit être configuré manuellement dans Stripe.
• Le reste du flux CPQ reste inchangé : configuration du devis, approbation, signature, PDF et synchronisation CRM continuent de fonctionner normalement.

Le bouton peut être modifié à tout moment avant que le devis ne soit signé. L’accès à ce paramètre est restreint par permission (Manage quote activation), il peut donc être réservé aux administrateurs ou rôles spécifiques de votre équipe.

​

Devis pour mise à jour d’abonnement

Un devis pour une mise à jour d’abonnement commence toujours par un abonnement client existant. Pour les abonnements importés de Stripe dans Hyperline, vous pouvez sélectionner l’abonnement que vous souhaitez mettre à jour pour commencer à créer un devis de mise à jour.

​

Gérer les factures

​

Conditions de paiement

Lors de la configuration d’un devis ou d’un client Hyperline, vous pouvez définir des conditions de paiement en jours. Ce paramètre est ensuite transmis à Stripe lorsque Hyperline crée l’abonnement associé, en remplissant le paramètre « days until due » lorsque la méthode de collecte est définie sur « send invoice » (c.-à-d. paiements par virement bancaire).

​

Numéro de bon de commande

Lors de la configuration d’un abonnement dans un devis, vous pouvez saisir un numéro de bon de commande (PO). Ce numéro sera synchronisé avec les paramètres de facture du client Stripe en tant que champ personnalisé, afin qu’il soit automatiquement affiché dans l’en-tête du PDF de la facture (numéro PO) lorsque l’abonnement est créé dans Stripe.

​

Marquer comme payé

Les factures Stripe impayées importées peuvent être marquées comme payées dans Hyperline. Sur la page de détails de la facture, cliquez sur « Actions » > « Mark as paid ». La facture apparaîtra alors comme payée dans Hyperline et sera marquée comme payée (paid out of band) dans Stripe.

​

Moyens de paiement clients

Comme mentionné précédemment, les moyens de paiement clients sont importés depuis Stripe et affichés dans Hyperline. Vous pouvez configurer les options de moyens de paiement disponibles dans la page de paramètres Payment de Hyperline, à la fois pour les moyens de paiement automatisés (carte, prélèvement automatique, etc.) et les comptes bancaires utilisés pour les virements bancaires manuels. Les moyens de paiement clients peuvent également être collectés pendant le processus de signature du devis. Lors de la création d’un devis, vous pouvez sélectionner les types de moyens de paiement que vous souhaitez que votre client utilise, et exiger la collecte du moyen de paiement pour signer le devis. Ensuite, sur la page publique du devis, votre client peut saisir les détails de son moyen de paiement (détails de carte, mandat de prélèvement, etc.). Ces détails sont automatiquement stockés dans le client Stripe associé, et Stripe Billing les utilisera ensuite pour facturer les futures factures.

​

Virements bancaires

Vous pouvez choisir que votre client paie par virement bancaire. Pour rendre cette option disponible sur les devis, configurez d’abord un compte bancaire dans les paramètres Payment de Hyperline et activez-le comme moyen de paiement. Lors de la création d’un devis, autorisez uniquement les virements bancaires en sélectionnant ce compte bancaire dans les paramètres de moyen de paiement du client (tous les autres types de moyens de paiement peuvent être désactivés). Les détails du compte bancaire seront alors affichés directement sur le devis :

• Si Stripe prend en charge les virements bancaires pour le client (en fonction de la devise, du pays, etc.), le numéro de compte bancaire virtuel Stripe attribué au client sera affiché.
• Sinon, le compte bancaire que vous avez configuré dans Hyperline sera affiché.

Dans ce scénario, le mode customer balance de Stripe sera utilisé.

​

Basculer les abonnements vers Hyperline

À un moment donné, vous pouvez vouloir basculer un abonnement de Stripe Billing vers Hyperline pour profiter des capacités et fonctionnalités supplémentaires de Hyperline pour gérer le cycle de vie de l’abonnement. Cela peut être fait en un seul clic en sélectionnant « Actions » > « Switch to Hyperline » sur la page de détails de l’abonnement. Hyperline propose également l’option d’annuler l’abonnement dans Stripe en même temps, vous aidant à éviter une double facturation future et des abonnements en double entre les deux plateformes.

​

Impact sur les clients

Avec ce flux, il n’y aura aucun impact sur vos clients finaux : leurs moyens de paiement seront importés depuis Stripe Payments, ils n’auront donc pas besoin de saisir à nouveau leurs détails de carte ou de créer un nouveau mandat de prélèvement. Les abonnements fonctionneront dans Hyperline avec exactement la même configuration que dans Stripe Billing sans interruption de service. De nouvelles factures seront créées et gérées par Hyperline, donc la seule différence pour les clients finaux sera la mise en page du PDF de la facture, car elle sera émise par Hyperline.

​

Réconcilier les clients entre les outils

Hyperline fournit un moyen de réconcilier les clients entre votre CRM, Hyperline et Stripe. C’est utile pour s’assurer que les données sont cohérentes entre tous les outils et pour éviter les doublons. Pour y parvenir, les clients Hyperline ont un champ External ID dédié, qui sert d’identifiant unique partagé entre HubSpot et Stripe. Dans la plupart des cas, cet ID correspond à votre ID client interne.

​

Dans votre CRM

Dans votre CRM, créez un champ personnalisé nommé hyperline_external_id pour HubSpot ou HyperlineExternalId__c pour Salesforce sur l’objet Company/Account. Assurez-vous que ce champ est rempli dans vos enregistrements CRM :

• Vous pouvez tirer parti des workflows pour remplir automatiquement ce champ avec des données provenant d’un autre champ ou source dans votre CRM, ou faire en sorte que votre équipe le saisisse dans le cadre de vos processus internes.
• Si vous n’avez pas d’ID dédié, vous pouvez utiliser l’ID client Stripe.
• Vous pouvez également utiliser l’ID client Hyperline.

La valeur de ce champ sera utilisée pour lier l’entité CRM au client Hyperline correspondant. Ce lien est créé la première fois que vous interagissez avec le widget Hyperline dans le CRM.

​

Dans Stripe

Avec la même logique, une clé d’External ID Hyperline (hyperlineExternalId) dans les métadonnées du client Stripe peut être utilisée.

• Si non configurée : Hyperline tentera de trouver le client Stripe associé en comparant l’External ID du client dans Hyperline avec l’ID client Stripe.
• Si configurée : Hyperline recherchera le client Stripe associé en utilisant les métadonnées hyperlineExternalId sur le client Stripe.

Cette logique de réconciliation n’est déclenchée que lorsqu’on tente de rechercher un client Stripe à partir d’un client Hyperline pour la première fois où Hyperline a besoin de créer un nouvel abonnement ou d’interagir avec Stripe et que le client n’est pas encore lié à un client Hyperline. Si aucune correspondance n’est trouvée, Hyperline créera un nouveau client Stripe et stockera l’External ID Hyperline associé dans les métadonnées.

​

Dans Hyperline

La valeur d’External ID réelle peut être trouvée sur la page de détails du client Hyperline, sous la section Integrations.

​

Synchroniser les propriétés personnalisées

​

Propriétés personnalisées client

La synchronisation des propriétés personnalisées client du CRM vers Stripe, ou simplement de Hyperline vers Stripe est également prise en charge. Dans Hyperline, vous pouvez créer des propriétés personnalisées pour vos clients :

1. Allez dans la page Custom properties de Hyperline
2. Cliquez sur « Add custom property »
3. Entrez un nom, un slug, sélectionnez un type, et sélectionnez « Customers » comme Enabled entities

Si l’objet Company/Account dans le CRM a un champ personnalisé avec le même slug, la valeur sera synchronisée du CRM vers la propriété personnalisée client Hyperline chaque fois que Hyperline synchronise un client depuis le CRM (c.-à-d. lorsque le widget est utilisé dans le CRM). Les propriétés personnalisées client Hyperline sont synchronisées vers Stripe en tant que métadonnées sur le client Stripe. Le slug de la propriété personnalisée est utilisé comme clé de métadonnées.

​

Propriétés personnalisées d’abonnement

Si vous créez une propriété personnalisée activée pour les entités « Subscriptions » (en utilisant le même processus que pour les clients ci-dessus), vous pourrez définir sa valeur lors de la création d’un abonnement ou lors de la configuration d’un abonnement dans le cadre d’un devis, y compris depuis le CRM (via l’interface Hyperline intégrée). Lorsque l’abonnement Hyperline est créé dans Stripe, les propriétés personnalisées associées sont synchronisées vers Stripe en tant que métadonnées sur l’abonnement Stripe. Le slug de la propriété personnalisée est utilisé comme clé de métadonnées.

​

Dates et fuseaux horaires

Hyperline prend en charge les paramètres spécifiques au fuseau horaire par client, tandis que Stripe fonctionne exclusivement en UTC. Cette différence peut entraîner un décalage d’une journée des dates dans Stripe. Par exemple, si le fuseau horaire d’un client est défini sur Europe/Paris et qu’un abonnement est configuré pour démarrer le 1er avril, Hyperline le représentera comme 31 mars à 22h00 UTC (pendant l’heure d’été, UTC+2). Étant donné que Stripe ne fonctionne qu’avec des dates UTC sans information de fuseau horaire, la date de début de l’abonnement dans Stripe apparaîtra comme 31 mars au lieu du 1er avril. C’est un comportement attendu et cela n’affecte pas la précision de la facturation — l’abonnement démarrera toujours à l’heure locale correcte pour le client. La même logique s’applique à tous les champs basés sur des dates synchronisés vers Stripe (dates de début d’abonnement, transitions de phase, etc.).

​

Connecter plusieurs comptes Stripe

Hyperline vous permet de connecter plusieurs comptes Stripe Billing à un seul compte Hyperline. C’est utile pour les organisations opérant dans plusieurs régions ou gérant différentes unités d’activité avec des comptes Stripe séparés. Dans cette configuration, vous pouvez importer des produits et coupons de plusieurs comptes Stripe dans votre catalogue de produits Hyperline. Chaque client Hyperline peut être lié à un compte Stripe spécifique (c.-à-d. qu’un seul client Hyperline peut être associé à plusieurs comptes Stripe). Lors de la création d’un devis, Hyperline filtre la liste des produits et coupons disponibles en fonction du premier produit sélectionné par l’utilisateur créant le devis. Ce premier produit sélectionné détermine quel compte Stripe sera utilisé pour le devis et pour la création de l’abonnement.

​

Détails techniques

​

Orchestration des abonnements Stripe

Lorsqu’un devis est signé, Hyperline orchestre automatiquement la création des abonnements dans Stripe Billing. Selon le contexte, Hyperline crée soit un subscription Stripe, soit un subscription schedule (par ex., lorsque l’abonnement inclut des phases futures ou des modifications planifiées). Tous les abonnements Stripe sont créés en mode flexible pour garantir la compatibilité avec les dernières capacités et fonctionnalités de Stripe. Cette orchestration est entièrement automatisée — aucune intervention manuelle n’est requise. Hyperline gère le mappage des produits, prix, coupons et phases vers leurs équivalents Stripe.

​

Rechercher des IDs Hyperline depuis Stripe

Lorsqu’un abonnement est créé dans Stripe, Hyperline ajoute automatiquement des champs de métadonnées personnalisés à l’objet abonnement Stripe correspondant :

• hyperlineSubscriptionId — L’ID d’abonnement Hyperline, stocké sur l’abonnement Stripe.
• hyperlinePhaseId — L’ID de phase Hyperline, stocké sur l’abonnement Stripe.
• hyperlineProductId — L’ID de produit Hyperline, stocké sur le produit d’abonnement Stripe.

Ces valeurs de métadonnées peuvent être utilisées pour rechercher les entités Hyperline associées depuis un abonnement Stripe en utilisant l’API Hyperline.