Collapse Menu
FastSpring App
Contact Support

Manual Renewal Subscriptions


This article describes manual renewal subscriptions, and explains how you can allow customers to opt out of having FastSpring save their payment details.

Table of Contents

With Manual Renewal Subscriptions, your customers can opt in or out of automatic subscription renewals. For customers who opt out (or do not opt-in in time), FastSpring does not store the payment account details for future usage. Manual-Renewal Subscriptions are unavailable with Managed Subscriptions. 

Unlike Automatic Subscriptions, Manual-Renewal Subscriptions may be purchased with delayed payment methods, including wire transfers and purchase orders. 

Customer Experience

When a non-managed subscription is placed in the customer’s cart, they are presented with an additional checkbox at checkout, labeled Securely save payment details for automated subscription renewal. By deselecting this checkbox, the subscription becomes a Manual-Renewal Subscription. 

If the customer opts out (or fails to opt in), they will not be billed automatically at the end of the first billing cycle. If configured in the subscription’s Pricing field, FastSpring will notify the customer when the next payment is due. To renew a subscription, the customer can follow these steps prior to the renew date: 

  1. Access the Account Management portal. Next to the Manual-Renewal Subscription, click Pay Now.
  2. The customer is taken to a secure page containing all order details except for the payment method. They cannot change the product or quantity from this page. 
  3. The customer enters their payment information. Contact information including name, and email are pre-populated based on the information in the Account Management portal. 
  4. When the payment is completed, the subscription renews for one billing period. 

Enable Manual-Renewal Subscriptions

Web Storefront:

  1. In the FastSpring App, navigate to Storefronts > Web Storefronts > Settings > General Settings
  2. In the Customer Information section, under Auto/Manual Subscription Renewal, select whether you would like to opt in or out of Manual Renewal Subscriptions. 
  3. Save your changes. 


Popup Storefront:

  1. In the FastSpring App, navigate to Storefronts > Popup Storefronts > Settings > Checkout
  2. In the Customer Information section, under Auto/Manual Subscription Renewal, select whether you would like to opt in or out of Manual Renewal Subscriptions. 
  3. Save your changes.

After you have enabled Manual Subscription Renewal, you can edit existing subscriptions to have manual renewals, or configure manual renewals for new subscriptions.


Change an Automatic Renewal Subscription to Manual Renewal

You can change a pre-configured subscription to have manual renewals through the App or by posting to the API. This will permanently delete the payment method associated with the subscription and cancel upcoming rebills. However, the customer can make payments prior to the next billing cycle through the account management portal to keep their subscription.

  1. On the subscription details page, click the green Renews automatically badge, and select Switch to renews manually.
  2. On the confirmation dialog, Click OK
  3. The Auto renew text is replaced by Manual renew to confirm that the change has been made.

Using the API:

POST to the /subscriptions endpoint using a POST body that includes the Subscription ID and "manualRenew":"true".

  • {
        "subscriptions": [
            "subscription": "subscription-id",
            "manualRenew": "true"

If you subscribe to the subscription.updated webhook event, the autoRenew field will display as false to indicate it is a manual-renewal subscription.


Configure Manual-Renewal Subscriptions for India-Based Customers

Due to new measures from the Reserve Bank of India, automatic rebills are no longer permitted for India-based sales. This applies to any pre-existing or future subscription with a payment card issued by an Indian bank.

FastSpring has automatically converted existing subscriptions that were created prior to October 1, 2021 to Manual Renewals. In order to sell new subscriptions (subscriptions created after October 1, 2021) to India-based subscribers, we recommend creating a separate storefront for these customers. This way, they can purchase a Manual-Renewal version while all other customers purchase the automatic-renewal subscription.

  1. Create a new webpage on your website for India-based customers. 
  2. Create a new Web Storefront or Popup Storefront in the App. 
  3. In the Subscriptions page, copy the subscription that you would like to provide as a Manual-Renewal Subscription for customers in India. 
  4. Change the copy to Manual-Renewal. See instructions above for more information. 
  5. Add the subscription to your new Storefront
  6. Publish the Storefront on your new webpage. 

Publishing the Storefront on your new Webpage

In order to ensure that customers are correctly billed for the automatic or manual subscriptions, we recommend tracking the IP address and redirecting accordingly prior to serving the page with the Store Builder Library.

If you allow your customers to select their location during checkout, we recommend configuring a subdomain for India-based customers to avoid loading the wrong storefront during the session.