Subscriptions with WooCommerce Payments is available for U.S. accounts and card payments only. Learn more.
When using WooCommerce Payments, you have two options to sell subscription products:
- Built-in subscription functionality; or
- WooCommerce Subscriptions extension.
This document provides information on using the subscriptions built-in to WooCommerce Payments.
If using the WooCommerce Subscriptions extension with WooCommerce Payments, everything will work as covered in the WooCommerce Subscriptions store manager guide. If you are already using WooCommerce Subscriptions and want to move to built-in subscriptions, refer to the guide to moving.
For help choosing the right solution for your business, refer to the guide comparing subscription options.
Eligibility requirements ↑ Back to top
To be eligible to use subscriptions built-in to WooCommerce, you must:
- Be based in the United States. Not yet available for territories of the US.
- Have the WooCommerce Payments plugin active.
- Have a WooCommerce Payments account that is enabled for payments.
- Offer credit and debit cards via WooCommerce Payments as a payment method on checkout.
Set up subscriptions ↑ Back to top
After setting up WooCommerce Payments version 3.2.0 or newer, subscription functionality will be available and ready to use. There is no special configuration required.
To create a subscription product:
- Go to WooCommerce > Products > Add new
- Select Simple Subscription as the product type.
- Set the terms for the subscription, including price, billing interval, billing period, length, sign-up fee and trial period (length, sign-up fee and trial period are all optional).
- Add any other product details you require, as instructed by Managing Products.
- Click Publish.
Your store now has a subscription product available that customers can subscribe to using WooCommerce Payments.
Once purchased, future recurring payments on the associated subscription will be processed automatically with renewal orders generated in your store for you to track and manage. You can also manage the subscriptions via the WooCommerce > Subscriptions administration dashboard.
Subscription settings ↑ Back to top
When you enable Subscriptions with WooCommerce Payments, you can find the Subscriptions setting at WP Admin > WooCommerce > Settings > Subscriptions:
Disable built-in subscriptions ↑ Back to top
When the WooCommerce Subscriptions extension is activated, the WooCommerce Payments built-in subscriptions functionality will be disabled automatically and the WooCommerce Subscriptions extension will take over.
If you need to manually disable subscriptions functionality built-in to WooCommerce Payments:
- Go to Payments > Settings
- Select Advanced settings at the bottom of the screen
- Select Enable Subscriptions with WooCommerce Payments to uncheck the box
Tracking fees ↑ Back to top
On subscription-related transactions via the subscription functionality built-in to WooCommerce Payments, an additional fee is charged. This fee is included on transactions for the initial sale of a subscription product and the future recurring payments associated with the subscription.
On the timeline of subscription-related transactions, visible under Payments > Transactions > Payment details screen, this fee will be displayed as a separate line item on the charge:
Extension compatibility ↑ Back to top
The WooCommerce.com marketplace offers many extensions for the WooCommerce Subscriptions extension itself that expand its functionality. Because the WooCommerce Subscriptions code is used to power subscriptions with WooCommerce Payments, many of these extensions can work with both subscription options. However, the extension may require a small change to be compatible, as explained in the Developer updates section of the add-on compatibility FAQ.
Preview availability ↑ Back to top
The subscription functionality built into WooCommerce Payments is currently available in preview release. During this time, it is only available to US merchants for debit and credit card payments. Merchants in the US can sell subscriptions to customers in other countries in over 100 different currencies.
If you want to see the built-in subscriptions functionality with WooCommerce Payments be made available in your country, or for WooCommerce Payments’ additional payment methods, please request or vote for that request on the Ideas board.
Renewal failures for cards from India ↑ Back to top
Currently, customers who are paying for WooCommerce Payments Subscriptions products using a card originated in India will see that their automatic subscription renewals are failing. This is due to Reserve Bank of India regulations around how payment processors can charge Indian cards.
With our regular Subscriptions extension, the merchants can move subscriptions using Indian cards to manual renewals to get around this. This requires the customer to come back to the site to renew. It’s not ideal, but it does work.
However, the issue for WooCommerce Payments Subscriptions is that it does not allow manual renewals. As a result, if an Indian customer signs up for a subscription product sold using WooCommerce Payments Subscriptions, the initial purchase will work, but all renewals after that will fail with
At that point, the customer will get an email alerting them that their renewal has failed. They will need to log into the merchant’s website and pay for the order manually, at which point the subscription will resume (until the next renewal, when it will fail again).