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.
Changes to a subscription product only apply to new subscribers. Existing customers keep their current pricing and terms unless you manually upgrade or downgrade their subscription. To update pricing for current subscribers, adjust their plan individually.
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
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.
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.