# Set up Metronome with Stripe

Set up Metronome billing with Stripe payment collection.

Use this checklist to set up Metronome with Stripe. Each step links to the detailed configuration instructions. For other guides and API reference, see the [Metronome documentation](https://docs.metronome.com/guides/get-started/home).

## Before you begin

Choose an [integration pattern](https://docs.stripe.com/billing/how-metronome-works-with-stripe.md#integration-patterns) before you complete the setup checklist. If you choose to use Metronome with Stripe Subscriptions, you must also [set up usage billing for your subscription customers](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md#configure-metronome-with-stripe-subscriptions).

## Setup checklist

Complete each linked guide.

1. Determine your [billing architecture](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture). If you need help, you can [talk to a Metronome specialist](https://metronome.com/contact-sales).
2. [Create your Metronome account](https://signup.metronome.com/) if you don’t have one.
3. [Set up invoicing with Stripe and Metronome](https://docs.metronome.com/integrations/invoice-integrations/stripe).
4. [Set up Stripe Tax](https://docs.metronome.com/integrations/tax-integrations/stripe-tax).
5. [Enable Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) to retry failed payments.
6. [Configure Metronome data export](https://docs.metronome.com/guides/reporting-insights/data-export/overview) and [Stripe Data Pipeline](https://docs.stripe.com/data/access-data-in-warehouse.md).
7. [Set up listeners for Metronome webhooks](https://docs.metronome.com/guides/platform-configuration/setup-webhooks) and [Stripe webhooks](https://docs.stripe.com/webhooks.md). Make sure you [verify incoming Stripe webhook signatures](https://docs.stripe.com/webhooks.md#verify-events) before you process events.
8. [Review the Metronome production checklist](https://docs.metronome.com/guides/implement-metronome/production-checklist).

## Configure Metronome with Stripe Subscriptions

If you use Stripe Subscriptions for recurring billing, configure Metronome to invoice usage for the same customers.

1. Determine when to create Metronome customers. The most common pattern is to create a Metronome customer when you create a subscription in Stripe. You can use Stripe [subscription webhooks](https://docs.stripe.com/billing/subscriptions/webhooks.md) to trigger customer creation in Metronome. Add the Stripe customer ID to the Metronome customer.
2. After you create the customer, create a [contract](https://docs.metronome.com/guides/implement-metronome/core-concepts/provision-contract), which defines the customer’s pricing terms. Add any associated [credits or commits](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit).
3. Begin sending usage for the new customer. Metronome collects, aggregates, and rates the usage according to the contract and [rate card](https://docs.metronome.com/guides/implement-metronome/core-concepts/create-manage-rate-cards), which defines product prices.
4. Metronome automatically forwards any non-zero invoices for these customers to Stripe at the end of the billing period.

For invoice lifecycle and payment behavior after setup, see the [Metronome invoice and payment reference](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md).
