Stripe Subscription

You can use the Stripe subscription component to let your users sign up for paid subscriptions plans for your software or services.

Skill Level: Intermediate

Before You Begin

• Ensure you have created a Stripe account, added your business information and bank account information, and completed any required verification.

• Users must be Logged in for the Subscription Component to work.

Walkthrough

Stripe Subscription

Set up your Product in Stripe

1. Go to Stripe Dashboard | Products

2. Click to create a new product

3. Enter Product information

   
4. When complete select

Add the Stripe Subscription Subscription Component to your App

1) Click the "+" button to open the Add Panel

2) Scroll down to Installed

3) Drag the Stripe Subscription Component onto your checkout screen

Configure your Subscription Payments Component

1. Click the Connect with Stripe button to connect your Stripe account

2. In Stripe Subscription Section:

   1. Copy your Price Plan ID (price_stringID) from Stripe to Adalo and input in the Stripe component that says price_id

      1. Go to Stripe Dashboard | Products
      2. Select your Product

      3. Copy the ID and then paste it into Adalo

         1. PriceID will look something like: price_1IHCB8FAwoyiOM0lgJc2v4ec

3. In Email Field section:

   1. You must specify the email address of the User that should receive email confirmation of the purchase. This is also how you will identify the customer in your Stripe Dashboard and is how the Component will know there is an active subscription.
4. Test Mode:

   1. Configure Test Mode to use this Feature.

Subscription Payment Successful

1. When a subscription is created successfully, the User will get a Confirmation and any subsequent actions will be completed.

   
2. Upon returning to the Screen with the Subscription Component, the Component will verify the Logged in User's email and show an Active Subscription if applicable.

   
3. The User will have an option for Subscription Settings where they can Update Subscription or Cancel Subscription if an Active Subscription is located based on the Logged in User Email.
4. The User can Unsubscribe and will receive confirmation.

   

Please Note: There is no option to receive User Subscription data from Stripe or validate Active Subscriptions from Stripe using the Stripe Marketplace Component. This must be done with a Custom Action using the Stripe | API Documentation

Subscription Payment Failed

1. Payment Declined

   1. When a subscription payment is declined, the User will receive the error below.

      
   2. This error is caused by an issue with Payment such as incorrect card details or insufficient funds.

   3. The User will remain on the Screen so they can attempt to subscribe again in the event there is an issue with the Payment Details.

   4. You can log into the Stripe Dashboard to see the reason for the error.

2. Subscription Error

   1. When a Subscription cannot be completed, the User will receive the error below.

      
   2. This issue is caused by an error with the Component setup such as invalid PriceID, issue with the Product Settings, incorrect or invalid User Email Address, User is not Logged into app, or Test Mode product used in Live Mode.

   3. Please verify setup of the component, validity of the PriceID, and User Flow before contacting Support.

Test Mode

1. Toggle on Test Mode in component

2. Enter your Stripe Test Secret Key and Test Publishable Key into Subscription component.

   • Stripe | API Keys Documentation can walk you through setting this up in your Stripe Account
3. Set up Test Product in Stripe

   1. Go to Stripe Dashboard | Product
   2. Enable Test Mode in top right hand corner of Dashboard
   3. Click to create a new product
   4. Enter Product information

      
   5. When complete select
   6. Update Price_ID in Subscription component.

   7. Open Previewer and complete payment flow as normal.

   8. Select appropriate Stripe | Test Mode Card for the scenario you want to test.
   9. Enter card info and select 'Pay Now'

Products created in Test Mode can be copied to Live mode but will have a different price_ID

Testing Successful

When you have finished testing your Subscription component and want to go live you will have to disable the Test mode and make sure you change the Price ID to a Live product.

Help

If you need additional help with this article, you can always ask in our community forum! Be sure to paste the link to this article in your post as well!