# Migrate to Metronome

Migrate your basic usage-based billing integration to Metronome.

Migrate from Stripe basic usage-based billing to Metronome. To learn about reasons to migrate, see [Compare basic usage-based billing and Metronome](https://docs.stripe.com/billing/subscriptions/usage-based/compare-metronome.md).

## Migration lifecycle

Follow these steps to migrate to Metronome:

1. [Scope your migration](https://docs.stripe.com/billing/subscriptions/usage-based/migrate-to-metronome/scope-your-migration.md) to identify what to migrate.
2. [Design your migration](https://docs.stripe.com/billing/subscriptions/usage-based/migrate-to-metronome/design-your-migration.md) to plan your technical approach.
3. [Set up Metronome](https://docs.stripe.com/billing/subscriptions/usage-based/migrate-to-metronome/set-up.md).
4. [Migrate existing customers](https://docs.stripe.com/billing/subscriptions/usage-based/migrate-to-metronome/migrate-existing-customers.md) from basic usage-based billing to Metronome.
5. [Test and deploy](https://docs.stripe.com/billing/subscriptions/usage-based/migrate-to-metronome/test-and-deploy.md) your migration.

## Documentation references

| Resource                                                                                                                                    | Description                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [Get your first invoice](https://docs.metronome.com/guides/get-started/metronome-dashboard-quickstart)                                      | Walk through the Metronome Dashboard to configure billing and generate your first invoice. |
| [API Quickstart](https://docs.metronome.com/guides/get-started/api-quickstart)                                                              | Set up your Metronome integration programmatically using the API.                          |
| [Metronome API Reference](https://docs.metronome.com/api-reference/introduction)                                                            | Complete reference for all Metronome API endpoints.                                        |
| [Design Metronome usage events](https://docs.metronome.com/guides/events/design-usage-events)                                               | Learn how to structure and send usage events to Metronome.                                 |
| [Billable metrics (SQL Editor)](https://docs.metronome.com/guides/implement-metronome/core-concepts/billable-metrics-sql-editor)            | Create complex billable metrics using SQL for advanced aggregation logic.                  |
| [Credits and commits](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits)                                        | Configure prepaid commits and promotional credits on contracts.                            |
| [Billing model guides](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides)                                            | Explore supported billing models including pay-as-you-go, prepaid, and hybrid.             |
| [Custom pricing units](https://docs.metronome.com/guides/pricing-packaging/make-pricing-changes/use-currency-custompricingunits)            | Bill in custom units (such as credits) rather than fiat currency.                          |
| [Embeddable dashboards](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/customer-dashboards-and-reporting) | Embed usage, invoice, and credit dashboards in your application.                           |
| [Metronome Webhooks](https://docs.metronome.com/guides/platform-configuration/setup-webhooks)                                               | Configure webhook notifications for billing events.                                        |
| [Metronome data export](https://docs.metronome.com/guides/reporting-insights/data-export/overview)                                          | Export metering, contract, and credit data from Metronome.                                 |
| [Production Checklist](https://docs.metronome.com/guides/implement-metronome/production-checklist)                                          | Validate your integration before going live.                                               |
| [Configure Stripe billing meters](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure.md)                            | Create and configure meters for basic usage-based billing.                                 |
| [Record meter events](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage-api.md)                                     | Record usage events using the Stripe API.                                                  |
| [Stripe Credit Grants API](https://docs.stripe.com/api/billing/credit-grant.md)                                                             | Manage prepaid credit grants on Stripe.                                                    |
| [Stripe Usage Analytics API](https://docs.stripe.com/billing/subscriptions/usage-based/analytics.md)                                        | Query meter usage data for analytics and customer-facing dashboards.                       |
| [Stripe test clocks](https://docs.stripe.com/billing/testing/test-clocks.md)                                                                | Simulate billing cycle progression for testing.                                            |