> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metronome.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Lancer un modèle d'affaires hybride
La tarification SaaS moderne évolue. De nombreuses entreprises qui facturaient auparavant un tarif fixe par siège évoluent désormais vers des modèles de tarification hybrides combinant revenus récurrents et composants à l'usage. Metronome prend en charge une large gamme de modèles d'affaires hybrides, vous aidant à équilibrer prévisibilité et potentiel de croissance.
Ce guide décrit comment lancer un modèle d'affaires hybride avec Metronome, notamment comment :
* Créer des contrats clients
* Couper l'accès aux fonctionnalités lorsque le client manque de crédits
* Configurer votre expérience de facturation pour l'utilisateur final
## Cas d'usage
Ce guide démontre un modèle d'affaires hybride en utilisant SeatsCo, une entreprise fictive avec un modèle existant basé sur les sièges. Dans cet exemple, vous introduisez les premières fonctionnalités IA de SeatsCo, et vous voulez ajouter un élément à l'usage à vos produits IA pour protéger les marges et capturer le potentiel des utilisateurs intensifs.
Voici comment fonctionne le nouveau modèle de tarification *Team plan* :
* Le client paie \$10/mois (ou \$100/an) par siège, et chaque siège inclut 100 crédits IA par mois pour les produits IA.
* Les crédits IA sont mutualisés et disponibles pour quiconque dans l'équipe. Les crédits IA de chaque mois expirent à la fin du mois — c'est utiliser ou perdre.
* Les crédits IA s'appliquent à trois produits IA : AI Assistant, AI Preview et AI Summary.
* Une fois les crédits IA épuisés, le client ne peut plus utiliser la fonctionnalité IA sur la plateforme SeatsCo.
* Le client peut choisir d'attendre le mois suivant pour la réinitialisation de ses crédits IA, ou il peut acheter un pack de recharge. Les packs de recharge ont une expiration d'un an et coûtent \$80 pour 1 000 crédits.
Lorsque vous activez ce modèle de tarification, Metronome gère entièrement le provisionnement des crédits. Cela signifie que vous n'avez pas besoin de maintenir du code pour calculer les prorata ou accorder de nouveaux crédits lorsque le client souscrit à un nouveau siège.
**INFO**
Un autre modèle de tarification courant est celui des crédits par siège, où chaque siège reçoit des crédits que seul lui peut utiliser. Voir [Crédit par siège individuel](/fr/guides/pricing-packaging/subscription/provision-your-customer#individual-seat-credit) pour modéliser ce cas d'usage dans Metronome.
## Blocs de construction Metronome
Dans Metronome, la [grille tarifaire](/fr/guides/implement-metronome/core-concepts/create-manage-rate-cards) est votre livre de prix centralisé. C'est là que vous encodez la tarification pour tous les produits, y compris les abonnements et les produits à l'usage.
Commencez par configurer ces objets Metronome essentiels : un produit d'abonnement, des métriques facturables, des produits d'utilisation et une grille tarifaire.
### Créer des produits d'abonnement
Créez un produit d'[abonnement](/fr/guides/pricing-packaging/billing-model-guides/create-a-subscription) appelé Team Plan.
Cet appel API montre comment créer un produit d'abonnement avec le point de terminaison [/v1/contract-pricing/products/create](/fr/api-reference/products/create-a-product) :
```bash theme={null}
curl https://api.metronome.com/v1/contract-pricing/products/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Team Plan",
"type": "SUBSCRIPTION"
}'
```
### Créer des produits d'utilisation
Créez des [métriques facturables](/fr/guides/implement-metronome/core-concepts/create-billable-metrics/) pour suivre la consommation de l'AI Assistant, AI Preview et AI Summary. Ensuite, créez des [produits d'utilisation](/fr/guides/implement-metronome/core-concepts/create-products-contracts) référençant ces métriques facturables.
Cet appel API montre comment créer un produit d'utilisation avec le point de terminaison [/v1/contract-pricing/products/create](/fr/api-reference/products/create-a-product) :
```bash theme={null}
curl https://api.metronome.com/v1/contract-pricing/products/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "AI Assistant",
"type": "USAGE",
"billable_metric_id": "00ca093f-f347-4dd3-bb9b-9705f1b015e3",
"tags": [
"AI Products"
]
}'
```
### Créer une grille tarifaire avec des produits d'abonnement et d'utilisation
Après avoir créé vos produits, créez une [grille tarifaire](/fr/guides/implement-metronome/core-concepts/create-manage-rate-cards). Lors de la création de la grille tarifaire, définissez le taux de conversion entre l'unité de tarification personnalisée *AI credits* et USD.
Cet appel API montre comment créer une grille tarifaire avec une conversion de tarification de crédit à l'aide du point de terminaison [/v1/contract-pricing/rate-cards/create](/fr/api-reference/rate-cards/create-a-rate-card) :
```bash theme={null}
curl https://api.metronome.com/v1/contract-pricing/rate-cards/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Subscription and Usage Pricebook",
"fiat_credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
"credit_type_conversions": [
{
"custom_credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6",
"fiat_per_custom_credit": 100
}
]
}'
```
Ensuite, ajoutez les produits que vous venez de créer à la grille tarifaire.
Cet appel API utilise le point de terminaison [/contract-pricing/rate-cards/addRates](/fr/api-reference/rate-cards/add-a-rate) pour ajouter le produit d'abonnement Team plan à la grille tarifaire avec deux fréquences de facturation : mensuelle et annuelle. Team plan est tarifé en USD. Il ajoute également trois produits d'utilisation à la grille tarifaire : AI Assistant, AI Preview et AI Summary, tous tarifés dans l'unité de tarification personnalisée AI credits.
```bash theme={null}
curl https://api.metronome.com/v1/contract-pricing/rate-cards/addRates \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"rate_card_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"rates": [
{
"product_id": "76f29162-7f5c-4ee6-89ed-ebbd592d767e",
"starting_at": "2025-01-01T00:00:00.000Z",
"entitled": true,
"rate_type": "FLAT",
"price": 10000,
"credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
"billing_frequency": "yearly"
},
{
"product_id": "76f29162-7f5c-4ee6-89ed-ebbd592d767e",
"starting_at": "2025-01-01T00:00:00.000Z",
"entitled": true,
"rate_type": "FLAT",
"price": 1000,
"credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
"billing_frequency": "monthly"
},
{
"product_id": "2fefe8b6-ca37-4355-a699-0a318e868902",
"starting_at": "2025-01-01T00:00:00.000Z",
"entitled": true,
"rate_type": "FLAT",
"price": 12,
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6"
},
{
"product_id": "c3b1ecc0-66ec-4a18-8782-7496c6e05248",
"starting_at": "2025-01-01T00:00:00.000Z",
"entitled": true,
"rate_type": "FLAT",
"price": 5,
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6"
},
{
"product_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
"starting_at": "2025-01-01T00:00:00.000Z",
"entitled": true,
"rate_type": "FLAT",
"price": 7,
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6"
}
]
}'
```
À tout moment, vous pouvez [mettre à jour la grille tarifaire](/fr/guides/implement-metronome/core-concepts/create-manage-rate-cards#update-a-rate-card%E2%80%8B) pour faire évoluer les tarifs que vous facturez pour les produits d'abonnement et d'utilisation.
## Implémenter un modèle hybride pour un client
Le contrat d'un client encode son accord spécifique avec SeatsCo. Pour modéliser des modèles de tarification hybrides où un siège est accompagné d'un certain montant de crédits, Metronome peut lier les crédits et engagements récurrents à un objet d'abonnement. Lorsque vous augmentez ou diminuez la quantité de l'abonnement, les crédits sont automatiquement provisionnés et suivis en fonction des comportements de prorata que vous définissez.
### Créer un abonnement et un crédit récurrent lié
Créez un [contrat client](/fr/guides/customers-billing/manage-customers/provision-a-customer#provision-a-customer-contract) référençant votre grille tarifaire.
Dans cet exemple, le client a souscrit au Team plan avec un paiement annuel et une quantité initiale de 4 sièges. Pour chaque siège, le client reçoit 100 crédits IA dans un pool partagé mensuellement.
Cet appel API montre comment créer le contrat décrit en utilisant le point de terminaison [/contracts/create](/fr/api-reference/contracts/create-a-contract). Les paramètres `subscription_config` dans cet exemple indiquent que si le client ajoute un siège en milieu de mois, le montant des crédits IA accordés pour ce siège est proratisé.
```bash theme={null}
curl https://api.metronome.com/v1/contracts/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"starting_at": "2025-06-01T00:00:00Z",
"rate_card_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c",
"subscriptions": [
{
"collection_schedule": "advance",
"initial_quantity": 4,
"proration": {
"invoice_behavior": "BILL_IMMEDIATELY",
"is_prorated": true
},
"subscription_rate": {
"billing_frequency": "annual",
"product_id": "76f29162-7f5c-4ee6-89ed-ebbd592d767e"
},
"temporary_id": "team_plan_annual"
}
],
"recurring_credits": [
{
"access_amount": {
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6",
"unit_price": 100
},
"commit_duration": {
"value": 1,
"unit": "periods"
},
"priority": 1,
"recurrence_frequency": "monthly",
"product_id": "652e1298-7638-45a8-b691-cdf47e46cbc8",
"starting_at": "2025-06-01T00:00:00Z",
"subscription_config": {
"subscription_id": "team_plan_annual",
"apply_seat_increase_config": {
"is_prorated": true
}
}
}
],
"billing_provider_configuration": {
"billing_provider":"STRIPE"
}
}'
```
### Augmenter les sièges et provisionner automatiquement les crédits
Lorsque le client souscrit à un nouveau siège, [modifiez le contrat](/fr/guides/pricing-packaging/make-pricing-changes/edit-contract) pour incrémenter la quantité. Vous n'avez pas besoin de toucher aux crédits — Metronome gère automatiquement leur provisionnement et leur prorata.
Cet appel API montre comment incrémenter la quantité de sièges de l'abonnement à l'aide du point de terminaison [editContract](/fr/api-reference/contracts/edit-a-contract) :
```bash theme={null}
curl https://api.metronome.com/v2/contracts/edit \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c",
"contract_id": "d701e556-c30e-4e9c-98af-304782d49345",
"update_subscriptions": [
{
"subscription_id": "e8cb4466-3e55-485e-b0ae-d83dfc4e82e1",
"quantity_updates": [
{
"starting_at": "2025-07-03T00:00:00Z",
"quantity_delta": 1
}
]
}
]
}'
```
Lorsqu'un client supprime un siège, décrémentez la quantité de sièges. Cet appel API montre comment décrémenter la quantité à l'aide du point de terminaison [editContract](/fr/api-reference/contracts/edit-a-contract) :
```bash theme={null}
curl https://api.metronome.com/v2/contracts/edit \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c",
"contract_id": "d701e556-c30e-4e9c-98af-304782d49345",
"update_subscriptions": [
{
"subscription_id": "e8cb4466-3e55-485e-b0ae-d83dfc4e82e1",
"quantity_updates": [
{
"starting_at": "2025-07-10T00:00:00Z",
"quantity_delta": -1
}
]
}
]
}'
```
### Définir une notification de seuil sur le solde de crédit
Vous pouvez définir des [notifications de seuil](/fr/guides/customers-billing/set-up-notifications/create-and-manage-notifications) sur le solde de crédit pour recevoir des webhooks lorsque le client est presque à court de crédits IA et lorsqu'il a entièrement épuisé ses crédits IA.
Sur réception de ces webhooks, vous pouvez bloquer l'accès du client à l'utilisation de davantage de crédits IA jusqu'à ce qu'il achète un pack de recharge ou que le mois se réinitialise.
Cet appel API montre comment créer une notification de seuil lorsque le client a 10 crédits IA restants à l'aide du point de terminaison [/alerts/create](/fr/api-reference/alerts/create-an-alert).
```bash theme={null}
curl https://api.metronome.com/v1/alerts/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"alert_type": "low_remaining_contract_credit_and_commit_balance_reached",
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6",
"threshold": 10,
"name": "10 AI credits remaining reached",
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c"
}'
```
### Activer l'achat de crédits de recharge
Si un client achète un pack de crédits de recharge, modifiez son contrat pour ajouter les crédits achetés. Pour vous assurer que les crédits IA mensuels inclus sont toujours consommés en premier, définissez la priorité des crédits achetés à un nombre supérieur à la priorité des crédits IA inclus.
Vous pouvez choisir de [conditionner ces crédits](/fr/guides/pricing-packaging/apply-credits-and-commits/manual-payment-gated-commits) au paiement dans Stripe ou tout autre fournisseur de facturation. Si vous conditionnez le paiement, les crédits ne sont libérés qu'une fois payés, vous protégeant contre la fraude.
Dans cet exemple, le client a acheté un pack de crédits de recharge au tarif remisé de \$80 pour 1 000 crédits IA. Ces crédits n'expirent qu'un an complet après leur achat, contrairement aux crédits mensuels inclus.
```bash theme={null}
curl https://api.metronome.com/v2/contracts/edit \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c",
"contract_id": "d701e556-c30e-4e9c-98af-304782d49345",
"add_commits": [
{
"product_id": "d6be3bf4-1669-40c9-a8b1-388bb167ab16",
"type": "prepaid",
"invoice_schedule": {
"schedule_items": [
{
"timestamp": "2025-07-07T00:00:00.000Z",
"amount": 8000
}
]
},
"access_schedule": {
"schedule_items": [
{
"amount": 1000,
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6",
"starting_at": "2025-07-07T00:00:00.000Z",
"ending_before": "2026-07-07T00:00:00.000Z"
}
]
},
"payment_gate_config": {
"payment_gate_type": "STRIPE",
"tax_type": "STRIPE",
"stripe_config": {
"payment_type": "PAYMENT_INTENT"
}
},
"priority": 100
}
]
}'
```
## Optimiser l'expérience de votre client
Utilisez Metronome pour offrir à vos clients des expériences de facturation robustes.
### Créer l'expérience de facturation client
Avec le nouveau composant de tarification à l'usage de SeatsCo, il est important de fournir une expérience de facturation client plus robuste, afin que les clients aient une visibilité en temps réel sur leur solde restant et puissent définir des contrôles de coût par siège.
### Obtenir le solde du crédit
Utilisez le point de terminaison [listCustomerBalances](/fr/api-reference/credits-and-commits/list-balances) pour afficher le solde actuel en crédits IA, y compris la consommation de tous les sièges.
### Définir des contrôles de coût par siège
L'administrateur d'une équipe peut vouloir plafonner le nombre de crédits IA qu'un utilisateur individuel peut dépenser. Pour ce faire, transmettez le `user_id` effectuant une action dans vos données d'événement, et définissez ce `user_id` comme [clé de groupe](/fr/guides/implement-metronome/core-concepts/create-billable-metrics#3-define-group-keys%E2%80%8B) sur les métriques facturables pertinentes.
Ensuite, créez une alerte de dépenses pour un `user_id` spécifique. Vous pouvez couper l'utilisateur de l'utilisation de davantage de crédits IA, notifier son administrateur ou le notifier.
Par exemple, cette alerte de dépenses d'exemple envoie une notification webhook lorsque `user_id = user_1234` dépense plus de 1 000 crédits IA dans la période de facturation.
```bash theme={null}
curl https://api.metronome.com/v1/alerts/create \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"alert_type": "spend_threshold_reached",
"credit_type_id": "d3cb2827-dcb5-44af-9354-947a7197b9a6",
"name": "user_1234 AI credit spend alert",
"threshold": 1000,
"customer_id": "d8319d6f-8ee0-43a7-b76f-d7587c0a811c",
"group_values": [{
"key": "user_id",
"value": "user_1234"
}]
}'
```
## Conclusion
SeatsCo est maintenant prêt à lancer ses fonctionnalités IA avec son nouveau modèle d'affaires hybride ! Ils ont configuré un plan d'abonnement avec des crédits IA par siège, le provisionnement et le prorata automatiques à mesure que des sièges sont ajoutés ou supprimés, des alertes de solde de crédit faible et la capacité pour les clients d'acheter des crédits de recharge. SeatsCo offre également aux clients une expérience de facturation transparente, avec une visibilité claire sur la consommation et les contrôles de dépenses.