Stripe Subscription

For Tradly SuperAdmin + Stripe Integration

This guide will walk you through setting up a Stripe-powered subscription system for your marketplace using Tradly’s SuperAdmin.

You’ll learn how to:

• ✅ Create products and prices in Stripe
• 🔗 Link plans via SKU to SuperAdmin
• 🔧 Configure Stripe webhooks
• 🧪 Enable and test the payment flow
• 🛠️ Fix misconfigurations (like missing SKUs or webhook issues)
• 🧼 Maintain your system long-term

​

🪜 Full Step-by-Step Setup Guide

​

🥇 Step 1: Create Products & Prices in Stripe

1. Log in to your Stripe Dashboard.
2. Navigate to Products → Click Add Product
3. For each plan (e.g., Free, Basic, Pro):
   • Enter the product name (e.g., Basic Plan)
   • Add a Price:
     • Type: Recurring → Choose Monthly or Yearly
     • Choose currency and set the amount
4. Copy the Price ID (e.g., price_1NKxyz...) — this will be used as the SKU in SuperAdmin.

​

🥈 Step 2: Add Subscriptions in SuperAdmin

1. Log in to Tradly SuperAdmin
2. Go to: Subscription Management → Click Add New Subscription

​

🔽 Fill in the form:

​

🥉 Step 3: Configure Stripe Webhook

1. Go to Stripe Dashboard → Developers → Webhooks
2. Click + Add endpoint, use the following format:

https://api.tradly.app/v1/payments/stripe/webhook/subscriptions/{your_tenant_name}

example: https://api.tradly.app/v1/payments/stripe/webhook/subscriptions/fashona

3. Under Events to send, select:

   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted

4. Click Add endpoint

5. Copy the Webhook Secret

​

🧾 Step 4: Setup Stripe Payment Gateway in SuperAdmin

1. In SuperAdmin, go to: Payments > Payment Methods
2. Click Add Payment Method
3. Select Stripe (Web)

​

⚙️ Configure API Keys

Click ⚙️ icon in the Stripe method row, then enter:

​

✅ Step 5: Test the Full Flow

1. Go to your marketplace website
2. Subscribe to a plan
3. You’ll be redirected to Stripe’s secure checkout
4. Complete payment
5. After success:
   • ✅ Subscription should be activated in SuperAdmin
   • ✅ Webhook events should sync in real-time

​

🔍 Subscription Block in Website Pages (Optional)

You can show your subscription plans on a custom page:

1. In the Editor, create a new page

2. Add the Subscription Block

   • This will automatically show plans from SuperAdmin

3. Add a CTA button (e.g., in header, footer, homepage)

   • Link it to your subscription page (e.g., /subscription)
   📌

   System behavior:
   If a user tries to add a listing without a valid subscription, theyll be redirected to this page.

​

🛠️ Common Subscription Plan Scenarios

​

➕ Scenario 1: Basic Plan

​

💎 Scenario 2: Premium Plan

​

❌ Troubleshooting Guide

​

🔄 Migrating or Fixing an Incorrect Setup

If your current plans are missing SKUs or inactive, follow this cleanup process:

​

✅ Step 0: Clean and Rebuild

1. Delete invalid plans in SuperAdmin (missing/incorrect SKUs)

2. Create new Products in Stripe with valid recurring prices

3. Recreate Subscriptions in SuperAdmin:

   • Paste Stripe Price ID into SKU
   • Fill out all other fields properly
   ✅

   Result: A clean and fully connected system.

​

🧼 Maintenance Tips

• If you update prices in Stripe, update the SKU in SuperAdmin
• Do not delete Stripe products linked to active plans
• Use Stripe Test Mode to validate before going live
• Add screenshots or highlights to make the process easier visually