Subscription products are best suited for recurring services, ongoing access to digital content, or products that require regular renewals, such as memberships, software licenses, or content platforms.

​
How to Add a Subscription Product

1

Navigate to the Dashboard

Log in to your Dodo Payments dashboard.
2

Go to the Products Section

Click Products in the sidebar to view your catalogue.
3

Add a New Product

Click Add New Product and select Subscription as the pricing type.
4

Enter Subscription Details

Fill in:
  • Subscription Name
  • Description
  • Recurring Price
  • Billing Cycle (monthly, yearly, etc.)
  • Free Trial (optional)
5

Save Your Subscription

Click Save. Your subscription plan is now available for customers.
You should see your new subscription listed in the catalogue.

​
How to Edit a Subscription Product

1

Access the Products Section

Go to Products in your dashboard.
2

Locate the Subscription to Edit

Find the subscription plan and click the edit button.
3

Update Subscription Details

Edit any of the following:
  • Billing Cycle
  • Price
  • Description
  • Add-Ons
4

Save Changes

Click Save to apply your updates.
Your changes will affect new customers and future renewals.
Editing a subscription does not affect current subscribers until their next renewal. Contact support to update terms for existing customers.

​
How to Archive a Subscription Product

1

Access the Products Section

Go to Products in your dashboard.
2

Find the Subscription to Archive

Locate the subscription plan you want to remove.
3

Archive the Subscription

Click the Archive Product button and confirm when prompted.
Archiving a subscription product prevents new signups but does not affect current subscribers. Contact support to remove subscriptions for existing customers.

​
Subscription Payment Flow

Mandate Creation Flow
Payment Renewal Flow

​
Subscription Cancellation

You or your customers can cancel subscriptions at any time via the dashboard or customer portal. Cancellation takes effect immediately, but access continues until the end of the current billing period. No automatic refunds are issued for cancellations.

​
On-Demand Subscriptions

On-demand subscriptions let you charge customers flexibly, not just on a fixed schedule. Contact support to enable this feature.
To create an on-demand subscription: To create an on-demand subscription, use the POST /subscriptions API endpoint and include the on_demand field in your request body. This allows you to authorize a payment method without an immediate charge, or set a custom initial price. To charge an on-demand subscription: For subsequent charges, use the POST /subscriptions/charge endpoint and specify the amount to charge the customer for that transaction.

​
Add-Ons

Add-Ons are optional, paid enhancements billed together with the main subscription. Customers can select add-ons during checkout.
1

Create an Add-On

Go to Products → Add-Ons tab and click Create Add-On. Fill in the details and save.
2

Associate Add-Ons with a Subscription

While creating or editing a subscription, select up to 3 add-ons to offer.
3

Customer Checkout Experience

Customers can select add-ons and quantities at checkout. All charges appear on a single invoice.
Add-Ons must be linked to a subscription and follow the same billing cycle.

​
Developer Integration

For Developers

Step-by-step integration guide to help developers implement the Subscription Payment product.