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

# Stripe

> Connect Stripe to sync revenue data, subscriptions, and payment information

<Info>
  **Who is this guide for?** This guide is for **administrators** setting up the Stripe integration. You'll need Stripe admin or developer access to create API keys.
</Info>

***

## What Data Syncs from Stripe?

| Stripe Object     | Maps to Quivly Object | What Syncs                                |
| ----------------- | --------------------- | ----------------------------------------- |
| **Customers**     | Customers             | Customer name, email, metadata, balance   |
| **Subscriptions** | Subscriptions         | Plan details, status, current period, MRR |
| **Invoices**      | Invoices              | Amount, status, due date, payment status  |
| **Products**      | Billing Products      | Product name, description, pricing        |

**Sync:** Continuous — changes stream in via webhooks

***

## Prerequisites

* Active Stripe account
* Access to authorize the connection (Admin or Developer role)

***

## Step-by-Step Setup

<Steps>
  <Step title="Open the integration">
    Go to **Settings** → **Integrations**, click the **Stripe** card, and open the **Configure** tab.
  </Step>

  <Step title="Connect">
    Complete the embedded connection flow — sign in to Stripe and approve access.

    <Check>
      Quivly only reads data. We never create, update, or charge customers in Stripe.
    </Check>
  </Step>

  <Step title="Verify Sync">
    1. Check the **Logs** tab to monitor sync activity
    2. Once data arrives, open a customer profile
    3. Go to the **Revenue** tab to verify Stripe data appears
  </Step>
</Steps>

***

## Customer Matching

Quivly uses email domain matching to link Stripe customers with CRM customers.

**Example:**

* Stripe customer with email `billing@acme.com`
* Salesforce account with domain `acme.com`
* Result: Matched as the same customer

<Warning>
  Customers with generic email domains (gmail.com, yahoo.com) may not match reliably. For better matching, store CRM customer IDs in Stripe customer metadata.
</Warning>