Configurer la facturation à la consommation

Ce guide vous accompagne pour mettre en place un workflow complet de facturation à la consommation dans Hyperline, depuis la connexion de vos données jusqu’au suivi de la consommation des clients. À la fin, vous disposerez d’un abonnement à la consommation opérationnel avec un suivi en temps réel.

Contexte

Vous souhaitez facturer vos clients en fonction de leur consommation réelle de votre produit ou service — par exemple appels API, heures de calcul, stockage, ou tout autre indicateur mesurable. Ce guide vous montre comment configurer cela de bout en bout via l’interface de Hyperline.

Prérequis

Avant de commencer, assurez-vous d’avoir :

Un accès à votre compte Hyperline (nous recommandons d’utiliser le mode test pour cette configuration)
Des données de consommation prêtes à être importées, ou la possibilité de générer des données simulées pour les tests
Une compréhension claire de l’indicateur que vous souhaitez facturer (par exemple appels API, Go stockés, heures utilisées)

Une fois inscrit et connecté à Hyperline, vous pouvez utiliser le mode test pour expérimenter avant de passer en production.

Étapes

1. Connecter vos données de consommation

Hyperline a besoin de données de consommation pour calculer les frais des produits à la consommation. Vous disposez de trois options pour connecter vos données :

Import CSV

Téléversez des données historiques depuis un fichier CSV

Intégration API

Envoyez des événements de manière programmatique via l’API

Chargeurs de données

Connectez-vous directement à votre base de données

Pour les tests, vous pouvez ignorer cette étape dans un premier temps et utiliser des événements simulés directement en mode test.

Utiliser les chargeurs de données (recommandé)

Les chargeurs de données vous permettent de récupérer des données de consommation directement depuis votre base de données, sans écrire de code. C’est idéal pour vous connecter à des sources de données existantes comme PostgreSQL, BigQuery, MongoDB ou Snowflake.

Accéder aux chargeurs de données

Rendez-vous sur la page des chargeurs de données dans Hyperline.

Créer une nouvelle connexion

Cliquez sur New connection et sélectionnez votre fournisseur de base de données dans la liste.

Saisir les détails de la connexion

Renseignez les informations de connexion à votre base de données :

Hôte et port
Nom de la base
Identifiants d’authentification
Paramètres SSL (si nécessaire)

Créer un chargeur de données

Une fois connecté, créez un nouveau chargeur de données avec une requête SQL qui renvoie :

timestamp - La date et l’heure de l’événement
customerId - L’identifiant unique de votre client
id - L’identifiant unique de l’événement
Tout autre champ que vous souhaitez suivre (par exemple quantity, region, product_type)

Tester et activer

Testez votre requête pour vous assurer que les données circulent correctement, puis activez le chargeur de données.

Pour en savoir plus sur la configuration des chargeurs de données, consultez nos guides détaillés :

2. Créer un produit à la consommation

Une fois vos événements ingérés dans Hyperline, vous pouvez créer un produit qui facture sur la base de cette consommation.

Accéder au catalogue de produits

Allez sur Products et cliquez sur New product.

Sélectionner le type de produit à la consommation

Choisissez Usage comme type de produit.Remplissez les informations de base du produit :

Name : un nom descriptif pour votre produit (par exemple « API Calls », « Storage GB »)
Description : détails facultatifs sur ce que représente ce produit

Lier un agrégateur

Connectez votre produit aux données de consommation que vous souhaitez facturer en sélectionnant un agrégateur. Si vous n’en avez pas encore créé, rendez-vous d’abord dans Usage > Aggregators.L’agrégateur définit :

Event type : quels événements agréger
Operation : comment calculer la consommation :
- Count : compter le nombre d’événements
- Sum : additionner une propriété numérique spécifique
Filters : conditions facultatives pour restreindre les événements éligibles

Définir les paliers de tarification

Configurez votre modèle de tarification :

Pricing model : choisissez parmi :
- Volume pricing : le prix unitaire change en fonction de la consommation totale
- Bulk pricing : toutes les unités sont facturées au tarif du palier atteint
- Basis points : tarification basée sur un pourcentage
Price tiers : définissez vos paliers et montants tarifaires
- Exemple : 0,10 $par unité pour 0-1 000 unités, 0,08$ par unité pour 1 001-10 000 unités
Billing interval : définissez à quel rythme ce produit doit être facturé (mensuel, trimestriel, annuel)

Veillez à configurer au moins un prix récurrent avant de passer à l’étape suivante.

Enregistrer le produit

Cliquez sur Save pour ajouter le produit à votre catalogue.

Exemple 💡

Vous souhaitez facturer des appels API avec une tarification volumique :

0-10 000 appels : 0,01 $ par appel
10 001-100 000 appels : 0,008 $ par appel
100 001+ appels : 0,005 $ par appel

Créez un agrégateur « Count » sur votre type d’événement API, liez-le à votre produit à la consommation, puis configurez trois paliers tarifaires avec ces taux.

Pour plus d’informations sur les options de configuration du comptage, consultez notre guide des produits à la consommation.

3. Créer un client

Avant d’attribuer un abonnement, vous avez besoin d’un client dans Hyperline.

Aller dans la section Customers

Rendez-vous sur Customers et cliquez sur New Customer.

Renseigner les détails du client

Saisissez les informations requises :

Name : nom du client ou de l’entreprise
Currency : la devise de facturation de ce client
Country : pays du client (utilisé pour le calcul des taxes)

Vous pouvez ajouter d’autres détails comme l’e-mail, l’adresse et les informations fiscales, ou les mettre à jour plus tard.

Enregistrer le client

Cliquez sur Save customer pour créer la fiche client.

Pour en savoir plus sur la gestion des clients, consultez notre guide de création de client.

4. Configurer un abonnement avec le produit à la consommation

Vous allez maintenant créer un abonnement qui inclut votre produit à la consommation.

Commencer la création d'un abonnement

Depuis la page de votre client, cliquez sur Actions → Assign new subscription.Vous pouvez également aller sur Subscriptions et sélectionner votre client.

Définir la durée de l'abonnement

Configurez le moment où l’abonnement démarre :

Immediately : commencer la facturation immédiatement
In the future : planifier pour une date précise
On checkout completion : attendre que le client finalise le paiement

Ajouter votre produit à la consommation

Cliquez sur Add product et sélectionnez le produit à la consommation que vous avez créé précédemment.Configurez les paramètres du produit :

Pricing : sélectionnez ou personnalisez le palier tarifaire
Metering period : choisissez quand la consommation est mesurée :
- Same as payment interval : la consommation se réinitialise à chaque cycle de facturation
- Committed period : la consommation est mesurée sur la durée totale du contrat
- Custom : définissez une fenêtre de comptage spécifique
Min/max amounts : définissez éventuellement des limites de dépense par période de facturation
Committed units : définissez des engagements minimums de consommation si nécessaire (le client paie au moins X unités)

Configurer les paramètres de paiement

Cliquez sur Next pour accéder aux paramètres de paiement.Pour les tests, sélectionnez Manually later afin de créer l’abonnement sans paiement immédiat.Pour la production, choisissez :

Checkout page : le client effectue le paiement via le checkout Hyperline
Immediately : débiter le moyen de paiement par défaut du client

Attribuer l'abonnement

Cliquez sur Assign subscription pour l’activer.Vous serez redirigé vers la page du client où vous pourrez voir l’abonnement et la consommation actuelle.

Exemple 💡

Un client souscrit à votre produit API avec une facturation mensuelle. Il s’engage sur un minimum de 5 000 appels API par mois (il sera facturé pour au moins 5 000 appels même s’il en utilise moins), et un plafond de dépense maximum de 500 $ par mois pour éviter les factures inattendues.

Pour plus de détails sur les options de configuration des abonnements, consultez notre guide de configuration d’abonnement.

5. Simuler la consommation (facultatif, pour tester)

Si vous êtes en mode test, vous pouvez simuler des événements de consommation pour voir comment la facturation fonctionne sans données réelles.

Aller dans l'onglet Events du client

Depuis la page de votre client, cliquez sur l’onglet Events.

Cliquer sur Simulate new events

Recherchez le bouton Simulate new events en haut de la liste des événements.

Configurer les événements simulés

Renseignez les détails :

Event type : utilisez le même type d’événement configuré dans votre produit
Date : choisissez la date à laquelle les événements se sont produits (doit être dans la période de facturation actuelle)
Number of events : combien d’événements créer
Payload (facultatif) : ajoutez des propriétés d’événement personnalisées au format JSON
```
{
  "quantity": 100,
  "region": "us-east-1"
}
```

Créer les événements

Cliquez sur Create new events. Les événements apparaîtront dans la liste des événements du client au bout de quelques secondes.

Vous pouvez supprimer les événements simulés à tout moment si vous avez besoin de réinitialiser vos données de test. Cette possibilité n’est disponible qu’en mode test.

Pour en savoir plus sur la simulation de consommation, consultez notre guide de simulation des données de consommation.

6. Suivre la consommation et comprendre les factures ouvertes

Après avoir créé des événements de consommation, vous pouvez suivre la consommation et prévisualiser les prochains frais.

Voir la consommation actuelle

Depuis l’onglet Subscriptions du client, vous verrez la consommation actuelle affichée à côté de chaque produit à la consommation. Cliquez sur l’icône en forme d’œil à côté du nombre d’unités pour ouvrir la fenêtre de détails de consommation, qui affiche :

La consommation totale pour la période de facturation actuelle
Les événements individuels contribuant à la consommation
Le montant calculé en fonction de vos paliers tarifaires
La répartition par période ou par propriété d’événement

Pour une analyse détaillée de la consommation et des exports, consultez notre guide d’exploration de la consommation.

Comprendre les factures ouvertes

Une facture ouverte est un aperçu en direct de la facture qui sera émise à la fin de la période de facturation. Pour les abonnements à la consommation, cette facture se met automatiquement à jour en temps réel à mesure que de nouveaux événements de consommation sont enregistrés. Caractéristiques clés des factures ouvertes :

Pas encore de numéro de facture : les factures ouvertes n’ont pas de numéro de facture définitif car elles sont en cours de calcul
Ne peuvent pas être payées : les clients ne peuvent pas payer une facture ouverte — elle est uniquement à des fins d’aperçu
Mise à jour en temps réel : à mesure que la consommation s’accumule, le montant de la facture augmente automatiquement
Visibles par les clients : les clients peuvent voir leur facture ouverte dans le portail client pour suivre leurs frais en cours

Pour consulter une facture ouverte :

Allez dans l’onglet Invoices du client
Recherchez la facture au statut open
Cliquez sur la facture pour voir les frais en cours et les lignes

Exemple 💡

Un client souscrit le 1er janvier avec une facturation mensuelle. Une facture ouverte est immédiatement créée pour la période du 1er au 31 janvier. À mesure qu’il effectue des appels API tout au long du mois, la facture se met à jour :

5 janvier : 2 500 appels → la facture affiche 25 $
15 janvier : 8 000 appels → la facture affiche 80 $
31 janvier : 15 000 appels → la facture affiche 138 $ (avec tarification par paliers)

Le 1er février, la facture entre en période de grâce pour examen final.

Cycle de vie d’une facture à la consommation

Les factures à la consommation suivent ce cycle de vie :

Open : la facture est créée au début de la période de facturation et se met à jour à mesure que la consommation s’accumule
Grace period : à la fin de la période de facturation, la facture entre en période de grâce (par défaut : 3 jours) pendant laquelle vous pouvez examiner et effectuer des ajustements manuels si nécessaire
To pay : après la période de grâce, la facture est finalisée avec un numéro de facture et envoyée pour paiement
Paid : le paiement est encaissé et la facture est réglée

Pendant la période de grâce, vous pouvez encore effectuer des ajustements sur la facture (ajouter des crédits, appliquer des remises, etc.). Une fois la période de grâce terminée, la facture est verrouillée et ne peut plus être modifiée.

Vous pouvez configurer la durée de la période de grâce dans Settings → Invoicing. Pour en savoir plus sur les conditions de facturation et périodes de grâce.

Étapes suivantes

Vous avez configuré avec succès un abonnement à la consommation ! Voici quelques pistes pour étendre votre implémentation :

Explorer les données de consommation

Consultez des rapports de consommation détaillés et exportez les données

Configurer les options de comptage

Découvrez les configurations avancées de comptage

Gérer les abonnements

Mettez à jour, mettez en pause ou annulez des abonnements