Set up manual renewal

Set up manual renewal

Use the following steps to enable manual-renewal subscriptions in your checkout flows, allowing customers to opt out of saving payment details and handle each renewal themselves.

Web checkout

Configure your web checkout to offer manual renewal by adjusting the Auto/Manual subscription renewal setting:

1. Go to Checkouts > Web Checkouts > General Settings.
2. Under Customer Information, set Auto/Manual subscription renewal to Allow, Opt-Out (details are saved by default, customers can opt out during the purchase).
3. Click Save.

Popup checkout

Update your popup checkout to allow customers to opt out of automatic renewals:

1. Go to Checkouts > Popup Checkouts > Checkout.
2. Under Customer Information, set Save Payment Method for Auto Subscription Renewals and Future Purchases to Allow, Opt-Out (details are saved by default, customers can opt out during the purchase).
3. Click Save.

Limitations:

• Manual renewal does not apply to managed subscriptions.
• Prorations are not available for manual-renewal subscriptions.
• Bundles with subscriptions will not renew automatically.

Customer-initiated renewals

Once manual renewal is enabled, customers manage each payment through their Account Management portal.

1. At checkout, customers see an unchecked box labeled Securely save payment details for automated renewal. If left unchecked, no payment method is stored, and the subscription is set to manual renewal.
2. When renewal is due, customers sign in to their Account Management portal and click Pay Now next to the subscription.
3. On the secure payment page, customers enter their payment details (product and quantity are fixed).
4. After payment, the subscription renews for one period. If payment is not received on time, the subscription will be canceled.

Note: RBI regulations require all India-issued cards to use manual renewal. Subscriptions with India-issued cards are automatically set to manual renewal.

Switch back to automatic renewal

At checkout, customers can re-enable auto-renewal by selecting the Securely save payment details for automated renewal checkbox. When they do, FastSpring stores their payment method and will automatically charge them on the schedule configured for the subscription.

Automate via API

Developers can toggle manual renewal programmatically. Send a POST request to the /subscriptions endpoint with your subscription ID and "manualRenew": "true" to turn off automatic renewals. See the endpoint URL and sample payload below.

Endpoint

POST https://api.fastspring.com/subscriptions

Request body
Replace your-subscription-ID with your subscription's ID:

{
  "subscriptions": [
    {
      "subscription": "your-subscription-ID",
      "manualRenew": "true"
    }
  ]
}

If you subscribe to the subscription.updated webhook, you can confirm that the autoRenew flag is now set to false.