> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdelta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Connect Stripe to import your customers, subscriptions, invoices, and transactions.

## What it does

The Stripe integration imports your billing data into Bigdelta, giving you a complete view of your customers, their subscriptions, and revenue metrics. Stripe is the primary payment integration and the recommended first step when setting up your workspace.

<Tip>
  Connect Stripe as the very first thing you do in Bigdelta. Most features — moments, and revenue analytics — depend on billing data to work.
</Tip>

***

## How to connect

<Steps>
  <Step title="Go to Settings then Integrations">
    Find the Stripe card in the payment providers section.
  </Step>

  <Step title="Click Connect">
    You will be redirected to Stripe to authorize the connection.
  </Step>

  <Step title="Authorize in Stripe">
    Log in to your Stripe account and grant Bigdelta read-only access. You will be redirected back to Bigdelta once complete.
  </Step>

  <Step title="Wait for the initial sync">
    Bigdelta begins importing your data immediately. For large datasets this may take a few minutes.
  </Step>
</Steps>

<Note>
  Bigdelta will **not** create charges, issue refunds, or modify your billing settings. The connection is read-only.
</Note>

***

## What data gets synced

| Stripe data        | Bigdelta data | Details                                                                             |
| ------------------ | ------------- | ----------------------------------------------------------------------------------- |
| Customers          | Accounts      | A Customer List is created containing all your Stripe customers                     |
| Subscriptions      | Subscriptions | Active, trialing, canceled, paused, and past-due subscriptions, including discounts |
| Invoices           | Invoices      | All invoice records including line items                                            |
| Payments / Charges | Transactions  | Payment amounts, statuses, and timestamps                                           |

### Revenue stages

Bigdelta automatically assigns a revenue stage to each account based on their Stripe subscription status:

| Stage          | Criteria                                     |
| -------------- | -------------------------------------------- |
| **Paying**     | Active subscription with successful payments |
| **Trialing**   | Currently on a trial period                  |
| **Non-Paying** | No active subscription or payment            |
| **Churned**    | Previously paying, subscription now canceled |

MRR (Monthly Recurring Revenue) is calculated automatically from your subscription data and updated with each sync.

***

## Initial sync

The first sync imports all historical data from your Stripe account. Depending on the volume of customers, subscriptions, and transactions, this can take anywhere from a few seconds to several minutes.

You can monitor the sync status in **Settings** then **Accounts**.

<Note>
  Stripe provides the most complete historical data of all supported providers. Active, canceled, and trialing subscriptions — including discounts — are fully available from history. Paused and overdue subscription statuses are accurately reflected from the moment the integration is connected, but historical paused/overdue status changes are not available. One-time products included in subscription invoices (such as setup fees) are excluded from MRR calculations but counted in net payments.
</Note>

***

## Ongoing sync

After the initial import, data syncs continuously. When a new customer signs up, a subscription changes, or a payment is processed in Stripe, the update appears in Bigdelta automatically.