# Charge app users with Stripe subscriptions

> Connect your Stripe account, show your plans with the Subscription component, tie roles to plans and let users manage their plan with My Subscription.

Source: https://tadabase.com/docs/users-security/adding-stripe-subscriptions  
Status: Verified Nov 17, 2026. Checked against the current product

Stripe subscriptions let your app's users pay you on a recurring basis. You set up the plans in Stripe, connect Stripe to your app, show the plans on a page with the **Subscription** component, and optionally keep pages for paying subscribers only.

> **Before you start:** Stripe subscriptions must be included in your Tadabase plan and switched on for your account. If **Subscription** is missing from **Settings**, or the Subscription components don't appear in the Page Builder after you enable it, contact Tadabase support. To charge a card once when a form is submitted, use [Stripe Checkout](https://tadabase.com/docs/integrations/stripe-checkout) instead.

## 1. Create your plans in Stripe

In your Stripe account, create a product for what you sell and add a recurring price for each plan (for example monthly and yearly). Give each price a clear nickname: it is the name Tadabase shows for the plan. Then copy your publishable key and secret key from Stripe's API keys page.

> **Note:** Use Stripe's test keys while you build. In an app environment other than production, only test keys work: subscriptions made there never charge a real card.

## 2. Connect Stripe to your app

1. **Open the subscription settings** In the builder, go to **Settings** > **Subscription**.
2. **Turn subscriptions on** On the **General** tab, set **Stripe Subscriptions** to **Enable**. The **API Credentials**, **Messages** and **Subscription Plans** tabs appear.
3. **Enter your keys** On the **API Credentials** tab, paste the Stripe publishable key into **API Key** and the secret key into **API Secret**, then save.
4. **Check your plans** On the **Subscription Plans** tab, the plans from your Stripe account are listed with their product and price. Click **Refresh Plans** after you change plans in Stripe. You can enter a **Title** for each plan.

The **Messages** tab holds the texts for each Stripe subscription status (trialing, active, incomplete, incomplete_expired, past_due, canceled, unpaid).

## 3. Tie a role to a plan (optional)

To keep pages for paying subscribers, create a role for each plan and link it to the Stripe plan. A page that allows only that role then lets a user in only while they have an active subscription to the plan; if the subscription lapses, they see a message instead of the page.

1. **Open the role** In the **Data Builder**, open the **Users** table, go to **Roles**, and open a role or click **Add a New User Role**.
2. **Link it to a plan** Set **Associate Role with a Subscription Plan** to **Enable** and choose the plan under **Stripe Product Plans**.
3. **Save** Click **Save**.

> **Warning:** Subscribing does not add the role to the user. Users still need the role in their **Role** field; see [Create user roles and assign users to them](https://tadabase.com/docs/users-security/roles).

## 4. Show your plans with the Subscription component

Add the **Subscription** component to a page that logged-in users can reach. Users must be logged in to subscribe: visitors who aren't see a login button instead of the subscribe button.

1. **Lay out the plans** In the component, use **Add New Plan Tab** to group plans (for example Monthly and Yearly), choose a plan layout (**1 Column** to **6 Columns**), and click **Add New Plan** for each plan.
2. **Describe each plan** Pick the Stripe plan for the plan box and use **Add New Plan Line** to add the lines of text users read, such as the price and what is included.
3. **Edit the plan's behavior** Click the pencil icon on a plan to open **Edit Plan Detail** and set the options described below, then click **Update**.
4. **Save the component** Click **Update & Save**.

For every setting of the component itself, see [Subscriptions](https://tadabase.com/docs/pages/subscriptions-alpha).

### Plan options

The **Edit Plan Detail** window has four tabs.

| Tab | What you set |
| --- | --- |
| **Options** | **Enable Plan** (show or hide the subscribe button for this plan), **Multiple Subscription** and its **Multiple Subscription Message**, the **Subscription Button Text** for **With Trial** (default "Authorize & Subscribe"), **Without Trial** (default "Pay & Subscribe") and **Login** (default "Login to continue"), and a **CSS Class**. |
| **Record Rules** | When the subscription starts, update the subscriber's record in the Users table (**Update this record**) or add a record (**Insert a new record**). Values can come from the subscription (**Stripe Value**), such as **Subscription ID**, **Last Invoice ID** or **Current Period End**. The tab keeps an older name: elsewhere in the builder this kind of automation has been replaced by workflows. |
| **Redirect Rules** | Send the user to a page after a successful subscription. Each rule has an optional **Condition** and a **Page**. |
| **Emails** | Send one or more emails after a successful subscription. Each email has an optional **Condition**, **Send To** recipients (To, Cc, Bcc or Reply-To; a custom address or an email field), **From Name**, **From Email**, **Subject** and **Message**, and can be switched off without deleting it. |

> **Note:** With **Multiple Subscription** set to **No**, a user who has ever subscribed to the plan sees the **Multiple Subscription Message** instead of the button, even if that subscription was canceled.

## Where subscriptions are stored

Each new subscription is saved in a hidden **User Subscriptions** table with the fields **User**, **Plan Name**, **Customer ID**, **Subscription ID**, **Product ID**, **Plan ID**, **Last Status** and **Created Date**. Tadabase uses it to check page access and repeat subscriptions. Payments, invoices and refunds live in your Stripe dashboard.

## 5. Let users manage their plan

Add the **My Subscription** component to a page for logged-in users. It has two tabs:

- **My Subscription**: each of the user's subscriptions with its status, a **Cancel** button (hidden once canceled) and an **Invoices** button.
- **Invoices**: the user's invoices with **Plan**, **Date**, **Amount** and **Status**, filtered by plan.

## Check that it works

1. **Use test keys** Enter your Stripe test keys under **API Credentials**.
2. **Subscribe as a user** Log in to the live app as a test user, open the page with the Subscription component and subscribe with one of Stripe's test cards, such as `4242 4242 4242 4242` with any future expiry date and any CVC.
3. **Check the result** The subscription appears in your Stripe test dashboard and in the user's **My Subscription** component, and any redirect, email or record update you set up runs.
4. **Go live** Replace the test keys with your live keys.
