PrérequisPour configurer les crédits, vous devez d’abord avoir connecté les événements afin que les données de consommation puissent être détectées.
Créer un produit de crédits
Pour commencer avec les crédits, vous devez d’abord créer un produit de crédits dans votre catalogue, où vous spécifierez les événements qui régissent la consommation. La consommation de crédits sera déduite automatiquement en conséquence.
Configuration du produit
Ajoutez un ou plusieurs agrégateurs pour définir quels événements consomment des crédits sur le solde du client. Chaque agrégateur a un poids qui détermine le nombre de crédits consommés par unité de consommation.Vous pouvez ajouter des agrégateurs directement depuis ce formulaire — si vous avez besoin d’un nouveau, cliquez sur Créer un agrégateur pour le configurer sans quitter la page.Vous pouvez également configurer les paramètres d’affichage (description publique) et définir un seuil de solde bas pour déclencher des avertissements sur le portail client. Le nom de l’unité affiché aux clients est hérité de l’agrégateur lié.
Plusieurs agrégateurs avec des poids
Un produit de crédits peut être lié à plusieurs agrégateurs, chacun avec son propre poids. Tous les agrégateurs consomment depuis un solde unique partagé, mais à des taux différents. Le poids définit le nombre de crédits déduits par unité de consommation pour cet agrégateur. Par exemple, un poids de3 signifie que chaque unité de consommation consomme 3 crédits.
Exemple 💡
Une plateforme d’IA vend des crédits qui peuvent être utilisés sur différents modèles :
Un client avec 1 000 crédits pourrait les utiliser pour 200 requêtes GPT-4, 1 000 requêtes GPT-3, 100 générations d’images ou toute combinaison.
| Agrégateur | Opération | Poids |
|---|---|---|
gpt4_requests | count | 5 |
gpt3_requests | count | 1 |
image_generation | count | 10 |
Configurer les crédits sur un client
Une fois votre produit de crédits configuré, vous pouvez activer un solde de crédits sur votre client et lier sa consommation de crédits immédiatement. Notez que cela peut aussi se faire via l’API.Sur la page de détails du client, allez dans l'onglet Crédits et cliquez sur Ajouter un solde de crédits
Formulaire de solde de crédits
Ici, vous pouvez également changer le nom, choisir le solde de départ et définir le seuil d’avertissement de crédits. Cela ne remplacera pas les valeurs précédemment définies dans votre catalogue de produits, mais sera spécifique au client.
Surveiller le solde et la consommation
Une fois le solde créé, un graphique de crédits montre l’évolution du solde au fil du temps. Vous pouvez ajuster la plage de dates et la granularité (quotidienne, hebdomadaire, mensuelle) pour analyser les schémas de consommation.Sous le graphique, le tableau des transactions liste tous les mouvements de crédits (recharges, consommations, expirations). Pour les produits avec plusieurs agrégateurs, une colonne Agrégateur indique quel agrégateur a déclenché chaque transaction de consommation. Vous pouvez cliquer sur une transaction de consommation pour inspecter et exporter les événements de consommation sous-jacents.Vous pouvez également recharger manuellement ou retirer des crédits via le menu Actions.
Ajouter des produits de crédits dans un forfait et un abonnement
Les produits de crédits créés dans le catalogue de produits peuvent être ajoutés aux forfaits de facturation prédéfinis et aux abonnements comme tout autre produit. Les options de ce produit peuvent également être modifiées au niveau du client/abonnement, permettant une personnalisation complète sans altérer la configuration de votre catalogue.Ordre de consommation
Le solde de crédits d’un client est un pool unique partagé. Lorsque la consommation est rapportée (via des événements ou viaPOST /v1/customers/{id}/credits/{productId}/usage), elle est déduite de ce pool.
À des fins de comptabilité et d’expiration, le montant déduit est attribué aux recharges individuelles dans l’ordre FIFO par date de création de la recharge — la recharge la plus ancienne est vidée en premier, la plus récente en dernier. Cela s’applique que la recharge ait une date d’expiration ou soit permanente.
L’ordre de consommation est basé sur le moment où chaque recharge a été créée, et non sur sa date d’expiration. Une recharge permanente créée avant une recharge à durée limitée sera vidée en premier.Si vous souhaitez qu’une allocation « gratuite » (par exemple une allocation mensuelle incluse au forfait) soit consommée avant les recharges payantes, assurez-vous que la recharge d’allocation soit créditée au solde avant toute recharge payante sur le même produit de crédits. Pour les allocations récurrentes liées à un abonnement, l’allocation est créditée au début de chaque période de facturation, donc tant que les recharges payantes ont lieu après ce point, l’allocation sera consommée en premier.
Expiration des crédits
Les crédits peuvent être configurés pour expirer automatiquement, garantissant que les crédits inutilisés ne restent pas indéfiniment sur les soldes des clients. Il existe deux façons de configurer l’expiration des crédits :Expiration après un nombre fixe de jours
Définissez un nombre spécifique de jours après lequel les crédits expireront. Ceci est utile pour les crédits promotionnels ou les offres à durée limitée. Lors de la configuration d’un produit de crédits sur un abonnement, vous pouvez spécifier après combien de jours suivant la recharge les crédits expireront.Expiration à la fin de la période de facturation
Les crédits peuvent être configurés pour expirer à la fin de chaque période de facturation. Ceci est utile pour les allocations de crédits mensuelles ou annuelles qui ne doivent pas être reportées. Lors de la configuration d’un produit de crédits sur un abonnement, vous pouvez activer cette option. Les crédits expireront automatiquement à la fin de la période de facturation, et de nouveaux crédits seront ajoutés au début de la période suivante.Lorsque les crédits expirent, une transaction d’expiration est automatiquement créée dans le grand livre de crédits, et le solde du client est réduit en conséquence. Les crédits les plus anciens expirent en premier.
Recharge automatique
La recharge automatique vous permet de reconstituer automatiquement le solde de crédits d’un client lorsqu’il tombe en dessous d’un seuil spécifié. Cela garantit un service ininterrompu à vos clients et réduit l’intervention manuelle.Comment fonctionne la recharge automatique
Lorsque le solde de crédits d’un client tombe en dessous du seuil de solde bas configuré, Hyperline peut automatiquement :- Créer une facture pour le montant de la recharge
- Débiter le mode de paiement du client
- Ajouter les crédits à son solde
Options de configuration
La recharge automatique peut être configurée de deux façons : Montant personnalisé : Spécifiez un montant fixe à débiter et le nombre de crédits à ajouter lorsque le seuil est atteint. Tarification par lot : Utilisez un prix par lot existant de votre catalogue de produits. Le système calculera automatiquement le montant correct en fonction de la tarification par lot.Exemple 💡
Si vous souhaitez ajouter 200 crédits et que votre lot est de 50 crédits pour 400 €, le système facturera 1 600 € pour 4 lots.
Configurer la recharge automatique
Lors de la création ou de la mise à jour d’un solde de crédits pour un client, vous pouvez configurer :- Le seuil de solde qui déclenche la recharge automatique
- Le nombre de crédits à ajouter lorsqu’elle est déclenchée
- Soit un montant personnalisé à débiter, soit la sélection d’un prix par lot dans votre catalogue