# Fonctionnement de Metronome avec Stripe Utilisez Metronome pour la facturation à l’usage et Stripe pour l’encaissement des paiements. Metronome et Stripe assurent une facturation de bout en bout pour les modèles de tarification avancés. Metronome gère la facturation à l’usage, la tarification basée sur les crédits, les contrats d’entreprise et la tarification multi-dimensionnelle. Stripe gère l’encaissement des paiements, le calcul des taxes, la comptabilisation des revenus, l’exportation des données et contribue à la détection des fraudes avec [Radar](https://docs.stripe.com/radar.md). Votre modèle de facturation et votre stratégie de croissance déterminent la façon dont vous choisissez d’intégrer Metronome à Stripe. ## Modèles de facturation pris en charge par Metronome Metronome prend en charge les modèles de facturation pour les stratégies de croissance portée par le produit (PLG) et les stratégies de croissance portée par les ventes (SLG). Vous pouvez combiner ces modèles pour répondre aux besoins de différents segments de clientèle et étapes du cycle de vie au sein d’un même système. ### Modèles libre-service et PLG - Facturation à l’usage pure avec encaissement automatique - Wallets de crédits prépayés avec consommation progressive - Rechargement automatique lorsque les soldes descendent en dessous d’un seuil - Achats de crédits conditionnés au paiement, les crédits n’étant débloqués qu’après un paiement réussi - Modèles à seuil de dépenses qui limitent l’exposition et évitent les factures imprévues - Cycles de vie des abonnements incluant les essais, les changements de niveau (passage à un abonnement supérieur ou inférieur) et le modèle hybride prépayé avec dépassement Consultez [Seuils de solde prépayé](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds) et [Créer un engagement prépayé](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit). ### Modèles portés par les ventes et modèles d’entreprise - Engagements postpayés avec accord de dépenses minimales et facturation de compensation pour les dépassements - Engagements d’entreprise prépayés avec consommation progressive et facturation des dépassements - Facturation à l’usage avec conditions de paiement à terme - Architectures de crédits multi-wallets avec règles de priorité entre les différentes échelles (par exemple, pool par utilisateur en premier, puis engagement au niveau de l’organisation) - Configurations multi-entités et multi-Stripe pour des configurations régionales ou spécifiques à un contrat Consultez [Engagements d’entreprise](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit) et [Créer des produits et des contrats](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts). De nombreuses entreprises utilisent les deux stratégies de croissance en parallèle : par exemple, les utilisateurs démarrent avec un essai gratuit assorti de seuils de dépenses, passent aux crédits prépayés avec rechargement automatique, puis les entreprises clientes basculent vers des contrats avec engagement. Pour des présentations détaillées, consultez [Guides des modèles de facturation](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/guides-home). ## Modèles d’intégration Metronome peut fonctionner de deux façons aux côtés de Stripe : - **Metronome indépendamment** : Metronome gère l’intégralité de la facturation et des mesures, puis transmet les factures finalisées à Stripe pour l’encaissement des paiements. - **Metronome avec Stripe Subscriptions** : Stripe Subscriptions gère votre facturation récurrente basée sur les sièges ou à tarif fixe. Metronome fonctionne en parallèle, en gérant séparément les mesures et la facturation à l’usage. Les deux systèmes créent des factures pour le même Customer Stripe. Les deux modèles utilisent le même mécanisme : Metronome transmet les [factures finalisées](https://docs.metronome.com/integrations/invoice-integrations/stripe) à Stripe via l’[API Invoicing](https://docs.stripe.com/api/invoices.md). Cette synchronisation de facturation est unidirectionnelle, ce qui signifie que Stripe ne renvoie pas les données de facture à Metronome. Pour plus d’informations, consultez [Fonctionnement de la facturation](https://docs.metronome.com/guides/get-started/core-concepts/how-invoicing-works). Pour toutes les factures Metronome transmises à Stripe, l’état du paiement Stripe est synchronisé automatiquement vers Metronome. ### Quand choisir chaque modèle Choisissez **Metronome indépendamment** si vous migrez depuis un système de facturation à l’usage existant ou si vous partez de zéro. Ce modèle vous donne accès à l’ensemble des fonctionnalités de la plateforme de facturation Metronome, mais nécessite un travail d’intégration personnalisé pour certaines interfaces Stripe comme Checkout. Pour des conseils sur la planification de l’architecture, consultez [Planifier votre architecture de facturation](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture). Choisissez **Metronome avec Stripe Subscriptions** si vous utilisez déjà Stripe Subscriptions pour la facturation récurrente et souhaitez y ajouter une tarification à l’usage. Vos flux d’abonnement existants (notamment Checkout, Adaptive Pricing et Payment Links) continuent de fonctionner tels quels, et Metronome gère séparément les mesures d’utilisation et la facturation. ### Metronome indépendamment Vous envoyez des événements d’utilisation à Metronome. Metronome les traite via la logique de mesure, de tarification et de contrat, puis finalise les factures et les transmet à Stripe via l’API Invoicing. Stripe gère l’encaissement des paiements, les taxes, la comptabilisation des revenus et les rapports. ### Metronome avec Stripe Subscriptions Stripe Subscriptions gère votre tarification récurrente. Les clients s’inscrivent via votre flux existant (Checkout, Payment Links ou API). Parallèlement, vous envoyez des événements d’utilisation à Metronome. Metronome les traite et transmet les factures d’utilisation à Stripe pour le même client Stripe. Le client reçoit à la fois les factures d’abonnement (depuis Stripe) et les factures d’utilisation (depuis Metronome). #### Configurer Metronome avec Stripe Subscriptions 1. Déterminez quand les clients Metronome sont créés. Le modèle le plus courant consiste à créer ces objets lors de la création d’un nouvel abonnement dans Stripe. Stripe [envoie des webhooks](https://docs.stripe.com/billing/subscriptions/webhooks.md) pour ces événements, que vous pouvez utiliser pour déclencher la création dans Metronome. Assurez-vous que l’identifiant du client Stripe est ajouté au client Metronome. 1. Une fois le client créé, créez un contrat avec les crédits ou engagements associés (le cas échéant). 1. Commencez à envoyer l’utilisation du nouveau client. Metronome collecte, agrège et calcule le coût de l’utilisation selon le contrat et la grille tarifaire. 1. Toute facture non nulle est automatiquement transmise à Stripe à la fin de la période de facturation pour ces clients. ## Interopérabilité avec les produits Stripe | Produit Stripe | Niveau de support | Remarques | | --------------------------------------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [Invoicing](https://docs.stripe.com/invoicing.md) | Entièrement pris en charge | Les factures Metronome deviennent des factures Stripe standard. Gère les comptes clients, l’encaissement et la relance. | | [Tax](https://docs.stripe.com/tax.md) | Entièrement pris en charge | Calcule les taxes lors de la finalisation de la facture. Prend également en charge [Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok) et [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara). | | [Payments](https://docs.stripe.com/payments.md) | Entièrement pris en charge | Traite les paiements, effectue des nouvelles tentatives avec [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md), détecte les fraudes avec [Radar](https://docs.stripe.com/radar.md). | | [Revenue Recognition](https://docs.stripe.com/revenue-recognition.md) | Entièrement pris en charge | Génère des échéanciers ASC 606 / IFRS 15. Aucune configuration supplémentaire requise. | | [Data Pipeline et Sigma](https://docs.stripe.com/stripe-data.md) | Partiellement pris en charge | Interroge les données de factures, de paiements et de transactions Stripe. Les données spécifiques à Metronome (événements de mesure, état des contrats, registres de crédits) nécessitent l’[exportation des données Metronome](https://docs.metronome.com/guides/reporting-insights/data-export/overview). | | [Checkout](https://docs.stripe.com/payments/checkout.md) | Nécessite une intégration personnalisée | Checkout est conçu pour les inscriptions aux abonnements et les paiements ponctuels. Les factures Metronome utilisent les flux de paiement de facture de Stripe (paiement automatique ou page de facture hébergée), et non Checkout. | | [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) | Pas directement applicable | Adaptive Pricing convertit les prix au moment du paiement. Les factures Metronome arrivent avec des montants déjà calculés. | Nous renforçons activement l’interopérabilité avec Stripe. ## Concepts Metronome pour les développeurs Stripe | Équivalent Stripe | Concept Metronome | Définitions | | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | | [Compteur](https://docs.stripe.com/api/billing/meter.md) | [Indicateur facturable](https://docs.metronome.com/guides/get-started/core-concepts/create-billable-metrics) | Définit la comptabilisation de l’utilisation client (appels API, tokens, Go/heure). Prend en charge SUM, COUNT, MAX, UNIQUE. | | [Price](https://docs.stripe.com/api/prices.md) | [Tarif](https://docs.metronome.com/guides/get-started/core-concepts/create-manage-rate-cards) | Un prix associé à un indicateur facturable via une **grille tarifaire**, un modèle de tarification réutilisable. | | [Abonnement](https://docs.stripe.com/api/subscriptions.md) (approximativement) | [Contrat](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts) | Accord d’entreprise définissant les grilles tarifaires, les engagements, les crédits et les calendriers. | | [CreditGrant](https://docs.stripe.com/api/billing/credit-grant.md) | [Engagement prépayé](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit) | Paiement initial pour une utilisation engagée. Les crédits sont consommés progressivement. | | Sans équivalent direct | [Engagement postpayé](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit) | Accord de dépense minimale. Une facture de compensation est émise si l’utilisation est insuffisante. | | [Solde de crédits](https://docs.stripe.com/api/billing/credit-balance-summary.md) | [Grand livre de crédits](https://docs.metronome.com/api-reference/credits-and-commits/list-balances) | Suit les soldes de crédits, les consommations, les expirations et les reconductions. | | Sans équivalent direct | [Facturation par seuil](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds) | Rechargement automatique lorsque le solde de crédits passe sous un seuil. | | Sans équivalent direct | [Tarification dimensionnelle](https://docs.metronome.com/guides/pricing-packaging/overview) | Le prix varie selon les dimensions d’attributs sur le même indicateur. | ## Cycle de vie d’une facture Le cycle de vie de la facture est identique pour les deux modèles d’intégration : 1. **Finalisation de la facture** : à la fin d’une période de facturation (ou selon un calendrier contractuel), Metronome calcule et finalise une facture. 1. **Création des postes** : Metronome crée des objets [InvoiceItem](https://docs.stripe.com/api/invoiceitems.md) sur le client Stripe via l’API Stripe. Tous les postes sont créés avant l’objet Invoice lui-même, de sorte que les écouteurs en aval (fournisseurs de taxe, webhooks) aient accès à une facture complète à la création. 1. **Création de la facture** : Metronome appelle [POST /v1/invoices](https://docs.stripe.com/api/invoices/create.md) sur le client Stripe, ce qui attache automatiquement tous les postes en attente. 1. **Validation** : Metronome vérifie que le total de la facture Stripe correspond au total de la facture Metronome dans les limites d’une tolérance arrondie. 1. **Finalisation** : selon la configuration, les factures sont soit finalisées automatiquement, soit laissées à l’état de brouillon pour une vérification manuelle. Si un prestataire de services fiscaux (Stripe Tax, Anrok ou Avalara) est configuré, la finalisation peut être reportée jusqu’à ce que le prestataire applique la taxe. 1. **Consommation des webhooks** : Metronome écoute les webhooks Stripe (`invoice.finalized`, `invoice.paid`, `invoice.payment_failed`, `invoice.payment_succeeded`, `invoice.voided`, `invoice.marked_uncollectible`, `invoice.deleted`) pour suivre l’état du paiement et mettre à jour les enregistrements de factures. Pour un mappage webhook-état complet, consultez [Suivi de l’état des factures Stripe](https://docs.metronome.com/integrations/invoice-integrations/stripe#track-stripe-invoice-statuses-in-metronome). ### Attributs de la facture Le tableau suivant indique quel système contrôle chaque attribut de la facture après que Metronome a transmis une facture à Stripe : | Attribut de facture | Contrôlé par | | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Postes (noms, quantités, montants unitaires) | Metronome | | Détails des sous-postes (tarification échelonnée, clés de groupe de présentation) | Metronome (configurable via les [clés de groupe](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts#group-keys)) | | Métadonnées de la facture (`metronome_invoice_id`, `client_id`, `environment`) | Metronome ([règles de mappage d’entité](https://docs.metronome.com/integrations/invoice-integrations/stripe#create-optional-entity-mapping-rules)) | | Dates de la période de service sur les postes | Metronome | | Mode de recouvrement (`send_invoice` ou `charge_automatically`) | [Configurable pour chaque client](https://docs.metronome.com/integrations/invoice-integrations/stripe#set-the-customer-billing-configuration) | | Délai d’échéance (par exemple, Net 30) | [Configurable pour chaque client](https://docs.metronome.com/integrations/invoice-integrations/stripe#configure-optional-global-integration-settings-available) | | Comportement de type brouillon ou finalisation automatique | [Configuration au niveau du compte](https://docs.metronome.com/integrations/invoice-integrations/stripe#configure-optional-global-integration-settings-available) | | Calcul des taxes | [Stripe Tax](https://docs.metronome.com/integrations/tax-integrations/stripe-tax), [Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok) ou [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara) (appliqué après la création des postes par Metronome) | | Moyen de paiement, contrôle des fraudes Radar, [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) | Stripe | | Présentation de la facture, adaptation à votre marque, en-tête/pied de page | Stripe | | Moyens de paiement disponibles sur la facture | Stripe | ## Payments Une fois qu’une facture Metronome est finalisée dans Stripe, les fonctionnalités Stripe Payments suivantes sont disponibles : - **Recouvrement automatique** : utilise le moyen de paiement par défaut du client. Metronome prend en charge les deux [moyens de recouvrement](https://docs.metronome.com/integrations/invoice-integrations/stripe#set-the-customer-billing-configuration) suivants : `charge_automatically` (Stripe débite le moyen de paiement) et `send_invoice` (Stripe envoie un email au client). - [**Smart Retries**](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) : Stripe utilise le machine learning pour choisir les moments de relance optimaux en cas d’échec de paiement. - [**Relance et recouvrement de revenus**](https://docs.stripe.com/billing/revenue-recovery.md) : Stripe envoie des emails en cas d’échec de paiement et gère le cycle de nouvelles tentatives. Activez [la relance et le recouvrement de revenus Stripe](https://docs.stripe.com/billing/revenue-recovery.md) sur votre compte Stripe pour automatiser le suivi des paiements échoués. - **Radar** : effectue le contrôle des fraudes sur les paiements par carte bancaire. - **Moyens de paiement internationaux** : tous les moyens de paiement pris en charge par Stripe Invoicing sont disponibles (cartes bancaires, ACH, SEPA, virement bancaire et autres). - **Gestion des moyens de paiement** : Stripe est le système de référence pour les moyens de paiement des clients. ### Engagements soumis au paiement Metronome prend en charge les [engagements soumis au paiement](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/manual-payment-gated-commits) (y compris la [facturation par seuil et le rechargement automatique](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds)), où une facture Stripe doit être réglée avant que les crédits soient libérés. Cela inclut la prise en charge des paiements ACH avec une fenêtre de paiement de 13 jours. Si un paiement de rechargement automatique soumis au paiement échoue, Metronome annule la facture et désactive le rechargement automatique du contrat. Vous effectuez ensuite le suivi auprès du client et réactivez manuellement le contrat. Pour le processus complet, consultez [Seuil de solde prépayé](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds). ### Échecs de paiement Metronome suit l’état de paiement des factures Stripe via des webhooks. Stripe gère l’encaissement et la logique de nouvelles tentatives. Le chemin d’échec dépend de la configuration de la facture : - **Factures `charge_automatically`** : Stripe gère le cycle de nouvelles tentatives. Si les [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) sont activées, Stripe utilise le machine learning pour choisir les moments de relance optimaux (jusqu’à 8 tentatives dans une fenêtre configurable). Metronome reçoit `invoice.payment_failed` et met à jour l’état de la facture à `PAYMENT_FAILED`, mais n’effectue aucune nouvelle tentative. - **Factures `send_invoice`** : Stripe envoie la facture au client par email avec les instructions de paiement. Si le paiement n’est pas reçu à la date d’échéance, la facture reste à l’état open dans Stripe. Metronome suit l’état, mais les rappels de paiement et le suivi sont gérés par la [relance et le recouvrement de revenus](https://docs.stripe.com/billing/revenue-recovery.md) de Stripe. - **Facturation par seuil soumise au paiement** : si une facture de rechargement automatique conditionnelle au paiement échoue, Metronome définit le champ `is_enabled` du contrat sur false et annule la facture. Vous devez ensuite réactiver la facturation par seuil pour qu’elle puisse être déclenchée. Metronome déclenche des webhooks `invoice.billing_provider_error` en cas d’erreur lors de l’envoi d’une facture à Stripe (par exemple, le client Stripe n’existe pas ou ne dispose pas d’un moyen de paiement valide). Les erreurs survenant entièrement dans Stripe sont signalées via les [webhooks Stripe](https://docs.stripe.com/webhooks.md) directement. Pour la liste complète des événements Metronome, consultez [les types de webhooks Metronome](https://docs.metronome.com/guides/platform-configuration/setup-webhooks). ### Opérations post-facturation Après que Metronome a transmis une facture à Stripe, vous gérez les opérations suivantes directement dans Stripe ou vos autres systèmes (par exemple, votre ERP ou CRM) : - **Remboursements** : traitez les remboursements dans Stripe via le Dashboard ou l’[API Refunds](https://docs.stripe.com/refunds.md), votre ERP ou votre CRM. Pour créditer les facturations futures dans Metronome, consultez [Émettre des notes de crédit](https://docs.metronome.com/guides/invoices/invoice-optimization/issue-credit-memos). - **Ajustements de factures** : utilisez l’[API Metronome Credits](https://docs.metronome.com/api-reference/credits-and-commits/create-a-credit) pour émettre un crédit, puis annulez et relancez la facture dans Metronome et resynchronisez-la avec Stripe. - **Annulation de factures** : Metronome et Stripe gèrent leur enregistrement des factures de manière indépendante. Annulez la facture dans les deux systèmes (et tout autre système en aval) pour maintenir la cohérence des enregistrements. ## Démarrer 1. **Planifiez votre architecture de facturation** : déterminez si vous souhaitez utiliser Metronome de manière indépendante ou comme module d’utilisation complémentaire. Consultez [Planifier votre architecture de facturation](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture). 1. **Connectez Metronome à Stripe** : suivez [Facturation avec Stripe](https://docs.metronome.com/integrations/invoice-integrations/stripe). 1. **Configurez les taxes** : paramétrez [Stripe Tax](https://docs.metronome.com/integrations/tax-integrations/stripe-tax), [Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok) ou [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara). 1. **Activez Smart Retries** : [activez Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) pour maximiser les taux de réussite des paiements. 1. **Configurez les exportations de données** : paramétrez l’[exportation de données Metronome](https://docs.metronome.com/guides/reporting-insights/data-export/overview) et [Data Pipeline](https://docs.stripe.com/stripe-data/access-data-in-warehouse.md). 1. **Écoutez les webhooks** : configurez des écouteurs pour les [webhooks Metronome](https://docs.metronome.com/guides/platform-configuration/setup-webhooks) et les [webhooks Stripe](https://docs.stripe.com/webhooks.md). 1. **Vérifiez la liste de contrôle de production** : consultez la [liste de contrôle de production Metronome](https://docs.metronome.com/guides/implement-metronome/production-checklist). ## See also - [Fonctionnement de Metronome](https://docs.metronome.com/guides/get-started/how-metronome-works) - [Démarrage rapide avec l’API](https://docs.metronome.com/guides/get-started/api-quickstart) - [Guides du modèle de facturation](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/guides-home) - [Documentation de l’API Metronome](https://docs.metronome.com/api-reference/introduction)