# Payments & Subscriptions

Payment and subscription integrations bring in what your customers pay and subscribe to, as revenue and subscription metrics on **Metrics** — useful for SaaS and subscription businesses that plan on MRR, subscriptions and ARPA. Stripe and Mollie sit under the **PSP** tab on the **Integrations** page, Chargebee under **RGM**.

The general flow is on [Connecting an Integration](/doc/connecting-integrations-XTfOCgvGYz). When your company has more than one legal entity, connect from the **Integrations** page of the entity whose revenue this is.

| Integration | How you connect | What Peaky syncs |
|-------------|-----------------|------------------|
| [Stripe](#stripe) | Sign in to Stripe | Products, prices, subscriptions, payments |
| [Mollie](#mollie) | Sign in to Mollie | Paid payments    |
| [Chargebee](#chargebee) | Site and read-only API key | Item families, items, prices, subscriptions, invoices |


---

## Stripe


1. Find **Stripe** under the **PSP** tab and click **Connect**.
2. Sign in to Stripe and approve access.
3. You return to Peaky; the card is marked **Connected** and the first sync starts.

**What syncs:** your **catalog** (products and prices), **all subscriptions** — including canceled ones, refreshed in full on every sync so counts stay complete — and **payments**. Stripe also tells Peaky about new, canceled, paused and resumed subscriptions as they happen; the metrics pick those up at the next sync.

**Metrics** are broken down by **product**, **billing period**, **price** and **currency**, so monthly and annual plans stay apart:

| Metric | What it shows |
|--------|---------------|
| **Active Subscriptions**, **New Subscriptions**, **Renewed Subscriptions**, **Cancelled Subscriptions** | Subscription counts per month. A subscription counts as active until it **actually ends** — not when someone schedules the cancellation — so past months stay accurate |
| **Subscription Revenue**, **Committed Subscription Revenue**, **Recognized Subscription Revenue** | Subscription revenue; the committed version comes from your subscriptions, the recognized version from actual payments |
| **One-Off Revenue** | Payments outside a subscription |
| **ARPA** | Average revenue per account |
| **FX Rate** | The average exchange rate of payments in each currency |
| **Price** | Each catalog price's unit amount over time, from when it was created — for tracking list-price changes |
| **Discount** | Total coupon discount per month, by product, billing period, coupon name and currency. Percent, fixed-amount, one-time and repeating coupons all count |
| **Gross MRR**, **Net MRR**, **Discount Leakage** | Recurring revenue at list price, after discounts, and the difference given away in coupons |

In filters and charts, a **price** is labelled with its list amount (for example **$29.00**), not an internal Stripe name — run a sync if labels look out of date.

**MRR snapshots.** **Gross MRR**, **Net MRR** and **Discount Leakage** are recorded for the current month on each sync, and earlier months are kept, so you build up a history of how MRR evolves. They are split by the subscription's **currency** only — one headline figure per currency, no product or price breakdown. Only active and past-due subscriptions count (not trials); usage-based prices are left out, and tiered pricing is not included yet.


---

## Mollie


1. Find **Mollie** under the **PSP** tab and click **Connect**.
2. Sign in to Mollie and approve read access to payments, customers, subscriptions and orders.
3. You return to Peaky; the card is marked **Connected** and the first sync starts.

**What syncs:** your **paid payments**. Each sync reads them all again, so corrections in Mollie come through.

**Metrics**, split by **currency** and dated by when each payment was created: **Subscription Revenue**, **Recognized Subscription Revenue**, **One-Off Revenue**, **ARPA** (subscription revenue per paying subscription that month) and **FX Rate** (settlement against payment currency).


---

## Chargebee


1. Find **Chargebee** under the **RGM** tab and click **Connect**. A dialog explains how to create a key.
2. Log in to your Chargebee account and go to **Settings** > **Configure Chargebee**.
3. Scroll to **API Keys and Events** and open **API Keys**.
4. Click **+ Add API Key**, choose **Read-Only Key** and then **All**, give the key a name and click **Create Key**.
5. In Peaky, enter your **Site** (the `yoursite` part of `yoursite.chargebee.com`) and paste the **API Key**. Click **Connect**.

**What syncs:** your **item families**, **items** and **item prices**, **subscriptions**, and **paid and posted invoices**. After the first sync, subscriptions and invoices are picked up as they change.

**Metrics**, broken down by **item**, **item family**, **billing period** and **currency**:

* **MRR** and **ARR** from active subscriptions — plus **Committed MRR** and **Committed ARR** from your subscriptions, and **Recognized MRR** and **Recognized ARR** from invoice lines, spread over each line's service period
* **ARPA** and **ARPPA**
* **Active Subscriptions**, **New Subscriptions** and **Cancelled Subscriptions** — trials do not count as active
* **FX Rate** for multi-currency data

Items that were archived or deleted in Chargebee keep their history, labelled **(archived)** or **(deleted)**.