1. Documentation /
  2. WooCommerce Payments: Startup Guide /
  3. Subscriptions with WooCommerce Payments

Subscriptions with WooCommerce Payments

When using WooCommerce Payments, you have two options to sell subscription products:

This document provides information on using the subscriptions built into WooCommerce Payments. For help choosing the ideal solution for your business, refer to the guide comparing subscription options.

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.

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:

  1. Go to WooCommerce > Products > Add new
  2. Select Simple Subscription as the product type.
  3. 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).
  4. Add any other product details you require, as instructed by Managing Products.
  5. 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:

Viewing transactions linked to a subscription

↑ Back to top

To view all transactions for a particular subscription

  1. Go to WooCommerce > Subscriptions.
  2. Click the subscription ID number for the particular subscription you’re interested in.
    • This will open the Edit Subscription page for that particular subscription.
  1. At the bottom of the page, the Related Orders section contains all orders associated with that subscription.

Payment method changes

↑ Back to top

If needed, store owners can change the payment method used to pay for subscriptions order from the WooCommerce dashboard. To do so, follow these steps:

  1. Go to WooCommerce > Subscriptions.
  2. Click the subscription ID number for the particular subscription you’re interested in.
    • This will open the Edit Subscription page for that particular subscription.
  1. Click the pencil icon in the Billing section at the top.
  1. Scroll down to the bottom of the billing info form, to the Saved Payment Method dropdown.
  2. Click the dropdown menu and select a new payment method, if one is available.
  1. Click the Update button to update the subscription to use the new payment method.

Disable built-in subscriptions

↑ Back to top

NOTE: When the Subscriptions extension is activated, the built-in WooCommerce Payments subscriptions functionality will remain in use for pre-existing subscriptions only. Any subscriptions created after the activation of the Subscriptions extension will use the on-site billing engine.

If you need to manually disable subscriptions functionality built-in to WooCommerce Payments:

  1. Go to Payments > Settings
  2. Select Advanced settings at the bottom of the screen
  3. 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:

Example timeline of subscription-related payment

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.

This functionality will be made available to other supported countries and for other payment methods available in WooCommerce Payments, like Sofort and iDeal, in the coming months.

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 Feature Requests board.

Alternatively, you can use the WooCommerce Subscriptions extension with WooCommerce Payments in any supported country.

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 transaction_not_allowed.

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).

Migrating

↑ Back to top

If you’re using WooCommerce Payments, you have two options to sell subscription products:

  • The subscriptions functionality built into WooCommerce Payments, or…
  • The WooCommerce Subscriptions extension mentioned above.

If you are already using one subscription offering and want to migrate to the other option, please refer to our guides here:

WooCommerce

The most customizable eCommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment