# Stripe

Summerbase reads your customers, subscriptions and their history from Stripe. It doesn't change them.

The Stripe integration is a [source](/docs/integrations.md): it sends Summerbase data. Its slug, usually `stripe`, names everything that came from it, so the customer Stripe calls `cus_NfJG2nK3` is `stripe:cus_NfJG2nK3` in Summerbase. Stripe's ids keep working, and your own code can use them to find the same customers and subscriptions.

The subscriptions and prices Stripe sends live in the Stripe source: only Stripe can change their amounts, status, dates and terms. Other sources can still add properties to them. For a customer's name, email and the other promoted fields, Stripe's value gives way by default to a custom integration's and to changes your team makes by hand. You can change its priority on the integration's page.

Each Stripe product becomes a plan, and its prices become prices on that plan. You can rename plans in Summerbase or merge them with plans from other sources. See [Plans and prices](/docs/using-summerbase/how-your-data-fits-together.md#plans-and-prices).

## Connect

In Summerbase, go to **Settings**, then **Integrations**, choose **Add integration**, then **Stripe**, and follow the steps there. They tell you exactly what Summerbase needs from Stripe, and if something is missing, Summerbase says what.

To try Summerbase with Stripe's test mode, connect it in a separate project, so test data stays out of your real figures.

## The first import

Once connected, Summerbase imports your customers, subscriptions and their history. Large accounts can take a while. A banner shows the progress, and your figures are complete once it finishes.

When it's done, your project's reporting currency is set to the currency most of your subscriptions bill in. You can change it in [Metrics settings](/docs/using-summerbase/metrics-settings.md).

## What's counted

Summerbase counts what your customers are subscribed to pay, before tax. A few things to know:

- **Usage-based prices** aren't counted yet. They show as worth nothing.
- **One-off charges** aren't counted. MRR measures subscriptions only.
- **Past-due subscriptions** still count while Stripe keeps them active.

## If something goes wrong

If Stripe stops giving Summerbase access, Summerbase disconnects the integration and emails your organization's owner and admins. Nothing is lost. Connect again from the integration's page.

The integration's page also has a log of what happened, and actions to reconnect, import everything again, or disconnect.