Subscription Schedules
  • 13 Jul 2022
  • 2 Minutes to read
  • Dark

Subscription Schedules

  • Dark

A subscription schedule allows you to create and manage the lifecycle of a subscription by pre-defining expected changes. These changes can include updates to the subscription’s prices that are scheduled to automatically occur in the future.

Stripe API Version

In order to use Subscription Schedules customers need to make sure they are using Stripe API version 2020-08-27 and not a previous version before upgrading to Payments v5.1 and beyond.

Upgrade Your Org to Use Subscription Schedules

After upgrading to the latest Payments package that includes Subscription Schedules you'll notice that the Subscription object now includes two record types: Subscription and Subscription Schedule Phase. In order to use these record types properly you'll need to follow the steps below.

  1. Navigate to Blackthorn | Payments Admin → Click Stripe Billing → Click Assign Subscription Record type button → This will update all existing subscriptions to the new ‘Subscription’ record type.
  2. Navigate to Blackthorn | Payments Admin → Click Stripe Billing → Click Deploy Stripe Billing → This will add Subscription Schedule Phase Layout to the Subscription Schedule Phase Record Type and assign the two Subscription record types to profiles.
New Orgs

Customers installing Blackthorn Payments for the first time will notice the new object for Subscription Schedule and 2 new record types for Subscription once installation is complete.

Create a Subscription Schedule

Not Seeing Subscription Schedules?

Make sure you have upgraded to Payments v5.1 or higher.

LIMITATION: Webhook Events Initiated from Stripe Dashboard

Currently, customers will not be able to create or update Subscription Schedules from the Stripe dashboard and push to Salesforce. In order to create and update Subscription Schedules the customer will need to kick off the request in Salesforce and push to Stripe.

  1. Navigate to the Subscription Schedule object and click 'New' to create a new record.
    Note: You will notice that the same fields available on the Subscription object are here as well.
  2. Add a value in the Customer field.
    Note: This is the only required field.
  3. Click 'Save'.
What is a Subscription Schedule Phase?

A Subscription Schedule Phase is one of the record types related to the Subscription object. Previously, the Subscription object only had one record type. Now it will have two: Subscription and Subscription Schedule Phase.

Create the Subscription Schedule Phase

  1. Navigate to the related list on Subscription Schedule and click ‘New’ for the Subscription Schedule Phase.
  2. Select the Subscription Schedule Phase Record Type.
  3. Add Price if there is only one price for this Subscription. If there are multiple Stripe Prices, you should use Subscription Line Items.
  4. Select a Billing Method.
  5. Populate Iterations with the number associated with this phase. Is this the first iteration or the second, third, and so on.
  6. Select a date for the Date Ended field. This will signify the end of this Subscription Schedule Phase.
  7. You can add additional detail using the other fields on this record, but they are not required.
  8. Save your record.

Add Subscription Items

You only need to do this if you have more than one Stripe Price.

  1. Navigate to the Related List on the Subscription Schedule Phase you just created.
  2. Click ‘New’ on the related list item for Subscription Line Item.
  3. Add values to the QuantityPrice, and Product fields.
  4. Click ‘Save’.

What's Next