Gérer les contrats dans Stripe

Utilisez l’application Metronome Stripe pour créer et gérer des contrats basés sur l’utilisation directement depuis le tableau de bord Stripe. L’application connecte votre compte Metronome à Stripe, vous offrant une vue unifiée des clients, des revenus et des contrats sans quitter Stripe. Ce guide décrit comment installer et configurer l’application Metronome Stripe, gérer les clients et les contrats, et utiliser le tableau de bord des revenus de l’application.

​

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Un compte Metronome avec au moins un environnement de production configuré
• Un compte Stripe avec accès au tableau de bord Stripe
• L’intégration Stripe configurée dans Metronome

​

Installer l’application

1. Accédez au listing Metronome sur le Stripe App Marketplace.
2. Cliquez sur Installer l’application et suivez les instructions.
3. Après l’installation, l’application Metronome est accessible depuis le tableau de bord Stripe.

​

Se connecter à Metronome

Après avoir installé l’application, connectez-vous pour connecter votre compte Metronome :

1. Ouvrez l’application Metronome depuis le tableau de bord Stripe.
2. Cliquez sur Se connecter à Metronome.
3. Complétez le flux d’authentification.

​

Tableau de bord d’aperçu

L’onglet Aperçu fournit un instantané de votre facturation basée sur l’utilisation :

• Revenu total : montant total facturé à travers vos contrats Metronome.
• Revenu du mois dernier : montant facturé pour la période de facturation la plus récente.
• Meilleurs produits : vos produits générant le plus de revenus, les produits restants étant regroupés sous « Autre ».
• Événements d’utilisation : une tendance sur 30 jours des événements d’utilisation ingérés par Metronome, avec des séries distinctes pour les événements totaux et en double.
• Clients : nouveaux clients ajoutés au cours du mois dernier.

L’onglet Aperçu comprend également des liens pour ouvrir l’application Metronome et la documentation Metronome.

​

Gérer les clients

L’onglet Clients affiche tous les clients Stripe liés aux clients Metronome. Pour chaque client, l’application affiche :

• Date de création : quand le client a été ajouté en fonction de la date de création Stripe.
• Facturations à vie : montant total facturé au client.
• Statut de provisionnement : l’état des contrats du client — Actif, Bientôt actif ou Récemment terminé.

Depuis n’importe quelle ligne de client, vous pouvez :

• Voir le client dans Stripe pour voir son profil Stripe complet.
• Gérer dans Metronome pour ouvrir le client dans le tableau de bord Metronome pour une configuration avancée.
• Créer un contrat pour démarrer le flux de création de contrat pour ce client.

Si un client Stripe est lié à plusieurs clients Metronome, les actions Gérer dans Metronome et Créer un contrat se développent en sous-menus afin que vous puissiez sélectionner sur quel client Metronome agir.

​

Vue détaillée du client

Lorsque vous consultez la page de détail d’un client Stripe, le module Metronome affiche tous les contrats liés à ce client. Chaque contrat affiche le nom du contrat (à défaut, le nom de la carte tarifaire s’il n’est pas nommé), la période du contrat avec un indicateur « (Actif) » lorsque applicable, et les produits inclus dans le contrat. Si le client Stripe n’a pas encore de client Metronome correspondant, l’application en crée un automatiquement en utilisant le nom du client Stripe lorsque vous lancez la création du contrat.

​

Créer un contrat

Le flux de création de contrat est un assistant en quatre étapes qui vous guide dans la construction d’un contrat basé sur l’utilisation.

​

Étape 1 : Facturation

Configurez les conditions principales du contrat :

• Nom du contrat : un nom descriptif pour le contrat.
• Date de début : quand le contrat commence. Par défaut, aujourd’hui.
• Date de fin (optionnel) : quand le contrat se termine. Laissez vide pour des contrats à durée indéterminée.
• Calendrier de facturation : à quelle fréquence les factures d’utilisation sont générées — Mensuelle, Trimestrielle, Annuelle ou Hebdomadaire.
• Envoyer le : quand les factures sont envoyées — le 1er du mois ou la date de début du contrat.
• Conditions de paiement nettes : le nombre de jours dont dispose un client pour payer après l’émission d’une facture. Par défaut 30.

​

Étape 2 : Tarification

Sélectionnez une carte tarifaire et personnalisez optionnellement la tarification pour ce contrat :

• Carte tarifaire : choisissez parmi vos cartes tarifaires Metronome configurées. La carte tarifaire définit la tarification de base pour tous les produits du contrat.
• Remplacements de prix : appliquez des pourcentages de remise à des produits spécifiques, limités par des tags de produits et une plage de dates.

• Quantités d’abonnement : si la carte tarifaire inclut des produits d’abonnement, définissez la quantité initiale pour chaque poste d’abonnement.
• Prix : après avoir sélectionné une carte tarifaire, voyez un résumé de tous les produits et de leurs prix effectifs, y compris tous les remplacements appliqués. Vous pouvez cocher ou décocher des produits individuels pour remplacer leur autorisation sur ce contrat.

​

Étape 3 : Crédits

Ajoutez des crédits au contrat.

• Crédit : le nom qui sera utilisé sur le poste de facture lorsque ce crédit sera appliqué. (Cela provient d’un produit fixe défini dans Metronome.)
• Tags de produits applicables (optionnel) : restreignez quels produits peuvent tirer de ce crédit. Si omis, tous les produits d’utilisation sur le contrat consomment le crédit.
• Calendrier : comment les [crédits](/fr/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit) sont alloués :
  • Ponctuel : une seule allocation avec une date de début et une date de fin.
  • Mensuel : une allocation récurrente avec une date de début et une date de fin optionnelle.
  • Personnalisé : plusieurs segments, chacun avec sa propre date de début, date de fin et montants.
• Montant de facture : ce qui est facturé au client pour le crédit.
• Montant de crédit : le montant d’utilisation que le client reçoit.

​

Étape 4 : Confirmation

Cliquez sur Créer un contrat pour finaliser. Le contrat est créé avec la configuration de fournisseur de facturation existante du client Stripe, donc les factures circulent automatiquement vers Stripe.

​

Dépannage

​

Erreurs d’authentification

Si vous voyez « Une erreur s’est produite lors de la connexion à Metronome », essayez ces étapes :

1. Allez à la page Paramètres de l’application et cliquez sur Effacer les identifiants Metronome en cache sous les paramètres développeur.
2. Allez à app.metronome.com/logout et déconnectez-vous.
3. Revenez à l’application Metronome Stripe et cliquez sur « Se connecter »

​

Clients manquants

L’onglet Clients affiche uniquement les clients Stripe qui ont un client Metronome correspondant lié via la configuration de facturation Stripe dans le compte Metronome actuellement connecté. Si un client n’apparaît pas :

• Vérifiez que vous êtes connecté au bon compte Metronome.
  • Voir les erreurs d’authentification ci-dessus pour vous déconnecter et vous reconnecter
• Vérifiez que le client existe dans Metronome avec une configuration de facturation Stripe.
• Confirmez que le stripe_customer_id dans la configuration de facturation Metronome correspond à l’ID client Stripe.

​

Compte Stripe non lié

Si vous voyez « Le compte Metronome que vous avez connecté n’est pas lié à ce compte Stripe », l’intégration Stripe n’a pas été configurée dans votre environnement Metronome. Configurez l’intégration de facturation Stripe dans Metronome avant d’utiliser l’application. Pour des problèmes persistants, contactez support@metronome.com.