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

# Stripe Connector

> Sync Stripe payments, subscriptions, customers, and events into your data warehouse.

|                 |                           |
| --------------- | ------------------------- |
| **Source**      | ✅                         |
| **Destination** | —                         |
| **CDC**         | —                         |
| **Sync modes**  | Full Refresh, Incremental |

***

## Connection settings

| Field          | Description                                                          |
| -------------- | -------------------------------------------------------------------- |
| **Secret Key** | Stripe secret API key (`sk_live_...` or `sk_test_...` for test mode) |
| **Start Date** | Earliest date to sync from (ISO 8601 — e.g. `2024-01-01`)            |

***

## What you can sync

| Object               | Incremental cursor |
| -------------------- | ------------------ |
| Customers            | `created`          |
| Charges              | `created`          |
| Invoices             | `created`          |
| Invoice Items        | `date`             |
| Subscriptions        | `created`          |
| Subscription Items   | —                  |
| Plans / Prices       | `created`          |
| Products             | `created`          |
| Payment Intents      | `created`          |
| Refunds              | `created`          |
| Disputes             | `created`          |
| Events               | `created`          |
| Payouts              | `created`          |
| Balance Transactions | `created`          |
| Coupons              | `created`          |
| Promotion Codes      | —                  |
| Tax Rates            | —                  |
| Checkout Sessions    | `created`          |

***

## Incremental sync

All incremental syncs use the `created` timestamp as the cursor and use Stripe's `list` endpoints with `created[gte]` filters. Some objects without a `created` field are Full Refresh only.

***

## Notes

* Stripe API keys have rate limits — Zwiron respects Retry-After headers automatically
* For high-volume accounts (millions of charges), initial syncs may take several hours
* Use a **Restricted Key** instead of the full secret key — grant only `Read` access to the resources you need
* Test mode data (using `sk_test_...`) is synced separately from live data