Collapse Menu
Documentation
FastSpring App
Contact Support

Manual Renewal Subscriptions

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.

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 will regularly check for new subscriptions meeting the criteria above to change these subscriptions to Manual-Renewal.