Collapse Menu
Documentation
FastSpring App
Contact Support

Managed Subscriptions

Table of Contents

FastSpring offers Managed Subscriptions, which do not involve automatically scheduled charges. Instead, you have control over when FastSpring charges users for their subscriptions. This is beneficial for usage-based billing. You can initiate the charge via the /subscriptions endpoint, or from the subscription’s details page in the FastSpring App.

At checkout, customers provide their payment information; FastSpring automatically charges this payment method each time you initiate a charge. By default, the customer is charged the same amount that they were initially billed for the subscription, however you can update the pricing by posting to the /subscriptions endpoint. The updated price will reflect in the next billing you initiate.

Create a Managed Subscription

When configuring your Subscription, you can set the billing to Managed, which does not initiate any automatic charges.

  1. In the FastSpring App, navigate to Products > Subscriptions. Create a new subscription, or edit an existing one.
  2. If you are creating a new subscription, leave the Billing Cycle to the default value, as this will not apply to a Managed Subscription. After you click Create, select the subscription to access its details page.
  3. In the Pricing section, click Edit. A popup appears.
  4. Set the Subscription Type to Managed.
  5. Configure the remaining fields, as desired. When you are finished, click Create.

After you configure the Managed Subscription, the Pricing field on the Subscription Details page will display Adhoc to indicate that this is a Managed Subscription.

Initiate a Billing

With Managed Subscriptions, you can present customers with a unique UI to initiate charges, or you can charge them (with their approval) without requiring any actions from their end. You can do so through the FastSpring API or within the App.

FastSpring API

You can POST up to 10 subscription updates to the /subscriptions/charge endpoint. Each update should include the subscription ID. Do not pass larger amounts in an array. For security purposes, you should make multiple API calls to update a batch of more than 10 updates. For more information, see /subscriptions.

FastSpring App

  1. In the FastSpring App, navigate to the Activity page. Select the applicable subscription to access its details page.
  2. Click Charge on the right side of the subscription details.

The new charge occurs immediately. This will automatically reflect in the Charges section of the Subscription Details page.