Subscription
Subscription products let you offer recurring billing for memberships, SaaS, or ongoing services. Flexible billing cycles, free trials, and add-ons help you maximize revenue and customer value. Know how to create, manage, and integrate recurring subscription products in Dodo Payments, including add-ons and on-demand billing.
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
Navigate to the Dashboard
Log in to your Dodo Payments dashboard.
Go to the Products Section
Click Products in the sidebar to view your catalogue.
Add a New Product
Click Add New Product and select Subscription as the pricing type.
Enter Subscription Details
Fill in:
- Subscription Name
- Description
- Recurring Price
- Billing Cycle (monthly, yearly, etc.)
- Free Trial (optional)
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
Access the Products Section
Go to Products in your dashboard.
Locate the Subscription to Edit
Find the subscription plan and click the edit button.
Update Subscription Details
Edit any of the following:
- Billing Cycle
- Price
- Description
- Add-Ons
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 Delete a Subscription Product
Access the Products Section
Go to Products in your dashboard.
Find the Subscription to Delete
Locate the subscription plan you want to remove.
Delete the Subscription
Click the Delete button and confirm when prompted.
Deleting 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.
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.
Create an Add-On
Go to Products → Add-Ons tab and click Create Add-On. Fill in the details and save.
Associate Add-Ons with a Subscription
While creating or editing a subscription, select up to 3 add-ons to offer.
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.