> ## 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.

# Gérer le cycle de vie d'un abonnement

Utilisez l'API Metronome pour gérer le cycle de vie de l'abonnement de votre client, y compris les modifications tarifaires, les essais gratuits, les surclassements et les déclassements.

## Mettre à jour la tarification​

Un avantage essentiel de l'utilisation des abonnements Metronome est la gestion centralisée de la tarification via la rate card. Pour modifier le prix d'un abonnement, modifiez le prix du tarif d'abonnement associé sur la rate card. Tous les contrats héritent de la nouvelle tarification et les clients sont facturés au nouveau tarif au début de la prochaine période de facturation.

<Info>
  **INFO**

  Si vous appliquez un override de type overwrite au prix de l'abonnement sur le contrat, le contrat n'héritera pas des modifications apportées à la rate card. Il conservera le prix attribué via l'overwrite.
</Info>

## Configurer un essai gratuit​

Créer un essai gratuit dans Metronome suit le modèle général des remises : appliquez un override de tarif sur le contrat du client. Si vous souhaitez offrir un essai gratuit pour un abonnement, vous avez deux options, selon le comportement souhaité :

* **Si la période d'essai est inférieure à un cycle de facturation complet.**
  * Créez un abonnement sur le contrat qui débute à la date de début du contrat et se termine après la période d'essai gratuit. Ajoutez un override au tarif d'abonnement pour modifier le prix à 0 \$.
  * Créez un deuxième abonnement sur le contrat qui débute après la fin du premier.
* **Si la période d'essai est un cycle de facturation complet.**
  * Créez un abonnement sur le contrat qui débute au démarrage du contrat.
  * Ajoutez un override pour la période d'essai afin de modifier le tarif à 0 \$ pour cette période. Une fois cette période terminée, le client est automatiquement facturé au tarif de liste sur la rate card au début de la période suivante.

<INFO>
  **MODIFICATIONS TARIFAIRES**

  Dans Metronome, les abonnements ne peuvent avoir qu'un seul tarif par période de facturation. Cela vous permet de planifier des modifications tarifaires sur la rate card sans perturber les clients en milieu de cycle.
</INFO>

## Ajouter un abonnement à un contrat existant​

Ajoutez un nouvel abonnement à un contrat existant à l'aide de l'action `add_subscription` sur le [point de terminaison edit contract](/fr/api-reference/contracts/edit-a-contract). Assurez-vous que l'`entitlement` pour le tarif d'abonnement concerné est défini sur `true`. Ceci est le plus souvent utilisé pour modéliser des compléments d'abonnement.

## Surclasser ou déclasser un abonnement​

Facilitez une transition de contrat en utilisant le [point de terminaison create contract](/fr/api-reference/contracts/edit-a-contract) et en spécifiant le `type` de l'objet `transition` à `renewal`.

Metronome recommande de faciliter les surclassements et déclassements à l'aide des transitions de contrat pour plusieurs raisons :

* Mettez fin à votre premier abonnement et démarrez le second avec un seul appel API — en gérant automatiquement la proratisation.
* Souvent, différents packages d'abonnement peuvent avoir des tarifs différents. Mettre fin à un contrat et en commencer un nouveau offre une séparation et un audit nets des tarifs d'origine et nouveaux.
* Si vous utilisez des modèles d'abonnement basés sur les crédits, les transitions de contrat gèrent automatiquement la logique de report.

<INFO>
  **DÉCLASSEMENTS**

  Metronome ne prend en charge la proratisation que pour les surclassements, comme l'augmentation de la quantité ou l'ajout d'un nouvel abonnement en milieu de période. Pour les déclassements, comme la diminution de la quantité, le changement prend effet au début de la prochaine période de facturation.
</INFO>

## Annuler un abonnement​

Mettez fin à un abonnement dans Metronome soit en :

* Mettant fin au contrat en déplaçant la date de fin du contrat à l'heure de l'annulation à l'aide du [point de terminaison edit contract](/fr/api-reference/contracts/edit-a-contract).
* Mettant fin à l'abonnement sur le contrat en déplaçant la date de fin de l'abonnement à l'heure de l'annulation à l'aide du [point de terminaison edit contract](/fr/api-reference/contracts/edit-a-contract). Si vous utilisez cette méthode pour annuler un abonnement hybride, vous devez également mettre fin au crédit récurrent séparément.

Pour la plupart des annulations, Metronome recommande de mettre fin au contrat. Si le même client redémarre l'abonnement à l'avenir, créez un nouveau contrat à ce moment-là. Cela permet au contrat Metronome d'être la source de vérité pour savoir si un client a un plan actif pour votre produit.

<Warning>
  **AVERTISSEMENT**

  Étendre ou supprimer la date de fin d'un contrat ne met **pas** automatiquement à jour la date de fin de l'abonnement si la période de service la plus récente a déjà été finalisée. Pour les abonnements en avance, créez un nouvel abonnement à l'aide du point de terminaison [EditContract](/fr/api-reference/contracts/edit-a-contract) lors de l'extension du contrat pour vous assurer que le client aura un abonnement actif lors des futures périodes de service.
</Warning>
