Get 25% OFF! First-time customers. Code: DREAM26

Subscribe
  1. Native Integrations
  2. Stripe Subscription
Follow on WhatsApp

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:

FieldDescription
TitlePlan name (e.g., Basic , Pro )
SKUPaste Stripe Price ID (e.g., price_1NKxyz... )
DescriptionExplain the plan features
CurrencyChoose currency (e.g., USD )
AmountEnter price (e.g., 9.99 )
Allowed ListingsNumber of listings allowed (e.g., 10 )
Commission %Platform fee percentage (e.g., 10 )
Expiry DaysValidity period in days (e.g., 30 )
Payment MethodSelect Stripe
StatusSet as Active
⚙️

Important:
Go to Payments > Payment Methods → Click the Configuration button on the Header method.
Enable Subscription, and set Subscription Type as Stripe.


​
🥉 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
  1. Under Events to send, select:

    • customer.subscription.created
    • customer.subscription.updated
    • customer.subscription.deleted
  2. Click Add endpoint

  3. 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:

KeyWhere to find it
Publishable KeyStripe Dashboard → API Keys
Secret KeyStripe Dashboard → API Keys
Webhook SecretFrom Step 3 above

​
✅ 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

FieldExample
Title Basic Plan
Description Access to core features
Currency USD
Amount $9.99
SKU price_1NKabc...
Allowed Listings 10
Payment Method Stripe
Status Active

​
💎 Scenario 2: Premium Plan

FieldExample
Title Premium Plan
Description All features, priority support
Currency USD
Amount $29.99
SKU price_1NKxyz...
Allowed Listings Unlimited
Payment Method Stripe
Status Active

​
❌ Troubleshooting Guide

IssueFix
Cannot edit subscriptionsDelete and recreate with correct Stripe Price ID
Webhook not triggeringRecheck endpoint URL and selected events
Price mismatchMatch SuperAdmin amount with Stripe price
Duplicate SKUUse a unique Stripe Price ID per subscription (1:1 mapping)

​
🔄 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

Got questions?

No spam. You can unsubscribe at any time.