Collapse Menu
Documentation
FastSpring App
Contact Support

Configuring Trial Subscriptions

Table of Contents

Configure a free or discounted trial period for your subscription. FastSpring will bill the customers the discounted or free price for the number of billing periods that you configure. The upcoming billing schedule is visible to customers under Subscription Terms at checkout, and in their account management portal.  

If the trial period is free, FastSpring will still collect payment information at checkout to rebill the customer after the trial period. However, if you enable manual-renewal subscriptions, customers can opt out of saving payment details. In order to keep their subscription after the free trial, they must make a payment in the account management portal before the trial ends. 

Add a Free Trial Period

When you add a free trial period to your subscription, FastSpring collects payment information at checkout, but does not charge the customer until the free trial ends.

  1. Navigate to Products > Subscriptions. Create a new subscription, or select a subscription to edit. 
  2. In the Pricing section, click Edit. A popup appears. 
  3. In the Free Trial Days field, enter the number of days you would like the subscription to last. 
  4. Save your changes. 

Trial Reminders

FastSpring automatically emails a trial reminder to the customer before charging them for the subscription. You can edit the timing, content, and type of reminder in the Subscription Notifications and Cancellation section of the subscription details page. To customize trial reminders, see Customer Notifications

Add a Discounted Trial Period

If you configure a product discount on a subscription with a free trial, the discount applies after the free trial period ends. To discount the trial period, add a temporary product discount instead of a free trial.

  1. In the subscription details page, navigate to the discount section. Click Edit
  2. Select Use Volume Duration. In the corresponding field, enter the discount percent you would like to apply to the trial period. 
  3. Below Discount Duration, enter the number of billing periods that you would like the trial to last. 
  4. In the Reason field, optionally enter an explanation for the discount. 
  5. Save your changes. 

Repeated Free Trial Sign-Ups

If you detect that a customer has signed up for a free trial multiple times, you can use the webhooks and API to determine who the customer is and cancel future subscriptions. 

  1. Subscribe to the subscription.activated webhook event. FastSpring will provide the account ID for each new subscription. If the customer enters a known email address, FastSpring will associate the order with the account ID. 
  2. Use the account ID and the product ID to search for previous orders.
    • Using your external database: Design your database to detect duplicate trial orders. The script will check your database for previous orders with the same product and account IDs. 
    • Using the API: Send a GET request to the /accounts endpoint to include a list of orders associated with the account. Then, send a GET /orders request to return all completed orders. Search the orders for the subscription ID. 

If you find that a customer has used multiple free trial periods for the same subscription, you can design your script to automatically initiate a DELETE call to the /subscriptions endpoint. Include the new subscription ID and the parameter &billingPeriod=0. FastSpring will send a subscription deactivation message to the customer.