---
title: "The Stripe Connector"
canonical: "https://help.journy.io/space/journy/2698051598/The%20Stripe%20Connector"
format: markdown
---
> Macro (include)

# Topics

> Macro (toc)

# Overview

Stripe is a suite of APIs powering online payment processing and commerce solutions for internet businesses of all sizes. 

With our Stripe connector you can:

- See all customer data from Stripe, in one place! Quickly uncover each account's MRR and renewal date.
- Run automated actions when renewal is coming up or when a customer cancels its subscription. And measure whether your actions achieve aspired expansion and retention goals.
- Define lifecycle stages based on Stripe's subscription data, and push them downstream your engagement workflows, in your marketing automation, CRM and customer success systems. The Stripe data itself will automatically be synced as well.

# How to connect Stripe

First, you'll need to install our Stripe app from the [Marketplace](https://marketplace.stripe.com/).

After installing our app you'll be redirected to the settings view:

![image-20240408-114302.png](media://e3453af3-34b8-433b-a456-80d16c23fd75)

You'll need a secret to prove that you access to the right journy.io account.

Go to your connections and click the Connect button under the Stripe logo:

![image-20240408-114340.png](media://41b84878-f030-4327-be71-025b2d71a486)

Copy the secret displayed in the connect Stripe dialog:

![image-20240408-114419.png](media://bb52ec71-fbaa-417d-8064-b691fb732a4b)

If the secret is valid, you'll see that Stripe is connected:

![image-20240408-114449.png](media://1a60fe44-44bd-4295-8ed2-095c4aa308bd)

*cont.* 

![image-20240408-114501.png](media://f391293c-3b94-46a2-a1fa-8796a98ea374)

# Stripe source settings

Before we can sync users/accounts from Stripe to journy.io, you'll need to tell us a few things:

- What [journy.io](http://journy.io) property we should use to match Stripe Customer ID

![image-20250910-142240.png](media://a91434ba-a7ad-45a5-8c64-9c8ec0861af4)

![image-20250910-142439.png](media://e70281c8-afa6-47bd-98b5-c9b7ead52c94)



- or what Stipe metadata key we should be using for Customers in Stripe in order to match External ID of [journy.io](http://journy.io) user/account.

![image-20250910-142553.png](media://c7f218ad-53c9-48a5-b25a-4045cfcec6e5)

![image-20250910-142923.png](media://ecd5301d-3152-44ae-a05a-ce37690dc5a6)


# Setting up stages

Go to stage settings, let's use **Trial -> Customer -> Churn** as example:

- For trials, the subscription status should be equal to "trialing"
- For customers, the subscription status should be equal to "active", "incomplete", "incomplete_expired", "past_due" or "unpaid"
- For churn, the subscription status should be equal to "canceled"

![image-20240408-114748.png](media://4e26846b-8944-40b8-b4f5-83ce4a298bfe)

*cont.* 

![image-20240408-114755.png](media://9a8c1535-0e68-44e6-a614-5af9082d58f0)

*cont.* 

![image-20240408-114801.png](media://c7fe473e-f876-4cde-aa45-4cd0ee9f0676)

[Here's a complete list of all subscription statuses.](https://stripe.com/docs/billing/subscriptions/overview#subscription-statuses)

# Showing MRR and renewal date

Go to business settings:

- Choose Stripe's **Subscription MRR** as MRR
- Choose Stripe's **Subscription Current Period End** as renewal date

Note: Only accounts support this right now

![image-20240408-114844.png](media://3a046abc-d046-47d7-b7b7-9e6487316605)

> Macro (include)