Subscriptions



A subscription business model allows customers to subscribe to your products and be charged a recurring fee—usually monthly or yearly. The subscription business model is defined within the Content Management System (CMS) under Content Model. You can populate subscription information for a product through the Subscription attribute in the Contentful or Sanity Product content model.



Content Model

The Subscription attribute allows you to enter the following information associated with a subscription:

Navigate to Content Model and click Add Content Type.

Type in Subscription and click Create

Click Add field and select Text. Type in Name and select Short Text Click the Create and Configure button and select This field represents the Entry title.

Click Confirm Click Add field again and select Text--> Short Text for Slug and click Create Repeat for Presentation, Discount Percentage and Intervals, Prepaid Subscription, Gift Subscription, and Max Installments as seen below.



Now that the Subscription attribute is created, let's create the Subscription Interval.

Click Add Content Type in the Name field, type in Subscription Interval and Create.

Click Add field and select Text. Type in Name and select Short Text. Click Create and Configure and select This field represents the Entry title.

Add the other following fields as represented below.



When creating a Unit, please make sure that your Validation tab is selected as such.



Content-Type



After creating your Content Model, you need to create a Content Type that will define what your customers will see in your store.

Click Content and click Add Entry and select Subscription Intervals.

You are now ready to determine the intervals you want to offer your customers.

Type in the Interval Name associated with the Unit you want to create.

Repeat for all Units.

If you want to provide automatic savings to your customers when they select monthly subscriptions, you can create a content-type subscription here.

Click Add Entry and select Subscription.

For this document, we assume you want to create a Subscribe and Save 15% based on Monthly Subscriptions.

You can publish it when you're ready to test it on Staging or Production.







Content Model

When using Sanity, as in Contentful, you must create Subscription and Subscription Intervals in the Content Model.

Unlike Contentful, in Sanity Studio, defining your content models with code is by design.

It makes it easier to version control and puts you and your developers in control. So you decide precisely how the data structures should be.

Ask your developer or your agency to create it.

A good way to start is described here.



The OMS syncs with Contentful and Sanity. Once a product is marked subscribable, you will see the product set to Subscribable in the Chord Order Management System. Navigate to the Product page and notice the Subscribable checkbox. When left unchecked, the product is not available for Subscription.





Now that your products have been synced and marked as subscribable, your customers can create a subscription order on your site. 

Chord allows Customers to proceed with a single purchase and a subscription for the same product within their cart.





Customers can log in to the website through passwordless auth, which allows them to log in with just their email address.

Once logged in, customers can see all subscriptions associated with their email on their account page.



‌On their account page, Chord offers the ability for your customers to manage a subscription where the following behavior is available to them:











Click Subscription --> New Subscription.

You can either type in the customer's email address in the Customer dropdown or select one from the list

The Actionable Date This is when your subscription will start.



The Interval Length and Units are where you select how often you want to ship the products to your customer.

The Interval Units are either days, weeks, months, or even years.

The End Date is when your Subscription will terminate.

The Store is your website. 

Proceed with providing Billing and Shipping addresses.

In the Line Items section, select the product(s) and qty you need

Click Create



Let's suppose you need to create a Subscription for your customer at the interval of every two months for a year; you would select the following:



You can set up subscription email reminders several days before the next installments are shipped, allowing your customers to make any adjustments to the order before it is processed.

These emails templates found in your CMS are:

The Chord OMS contains two environment variables that determine when reminders are sent:

The OMS computes when a reminder should be sent based on the Subscription's actionable date and the value provided in these Environment Variables. 





Q: What are the statuses of a Subscription? 

Q: What are the Processing States of a Subscription?  New: Your subscription is being processed. When payment is processed, the processing state will update to Success. Failure: your Subscription has failed. Check the Installment tab and see if your Subscription is fulfilled. More often than not, a failed subscription is due to a payment issue. Expired credit cards are often the case. Success: Payment is successful, and your subscription is ready to be fulfilled



Q: Can I edit an Active Subscription? Yes, you can edit your subscription whenever you like. Navigate to your Subscription's page and make your edit/update as described above.  Q: Can I pause a subscription?  Yes, there are components in our SDK that allow you to provide your customers with the ability to Pause a Subscription in the front end, and you can also Pause it from within the OMS on behalf of your customers.

Q: What happens if a subscription with previously failed installments that are eligible for retry has been paused?

If a subscription with previously failed installments that are eligible for retry has been paused, OMS will not reprocess those installments.  Q: Can I delete a subscription?  We do recommend that you mark your Subscription as Cancelled. You can click the Cancel icon next to the Subscription you'd like to end/delete on your Subscription page.  Your customers can also end their Subscription in the front end, in My Account.    Q: Can I create a Subscription from within the OMS?  Yes, you can manually create a subscription in your OMS - Navigate to Subscriptions, click New Subscription, and refer to the OMS section in this guide.  Q: If I modify an existing Subscription in the OMS, will the customer see the change in their Account?   Yes, you can edit the Actionable Date, address, the dates, products, Payment, and more on your Subscription page.  Q: Can I change the products in an active subscription?  Yes, you can. You can scroll down to the Line items section and modify them there.  Q: What is an Actionable Date?  When you first create your Subscription, the Actionable Date is when the Subscription does start.  When your subscription is Active, the Actionable Date is the date of your next installment.  Q: Can I update an address to a subscription?  Yes, if you need to change billing or shipping addresses, you can do so on the Subscription page.  Q: Can I change the method of Payment in a subscription?  You can direct customers to update their credit cards on the Subscription page in My Account, or if they have placed an order with that same payment method, you can do it in the OMS on the Subscription page in the Payment section.   Q: Will my customers receive an email reminding them of an upcoming subscription?  Yes, Chord provides email template reminders in your CMS under Transactional Emails.  There are some Environment Variables configurations in Settings --> Store. For more information, please refer to Environment Variables document under the Transactional Emails section.  As described in the Emails section of this document, you can select to send your customers reminders. You can specify to send the reminder based on the days before the subscription actionable date.

Q: How are the reminder emails being calculated and sent?

We have a method in place that generates and sends your customers these reminders. They are based on the value you have provided in the Environment Variables and the Actionable Date of subscription orders.

That method is triggered in three places:

Q: If our customers modify their Actionable Date, will they get an email reminding them of the upcoming subscription shipment? This allows them to make any necessary order adjustments before it's shipped.

Absolutely! Your customers can make changes to their subscription's Actionable Date, whether they choose an earlier or a later date, they will still receive a reminder email.

The email reminder date will automatically be adjusted based on the new Actionable Date they've selected. This ensures that they're informed and have the opportunity to make any last-minute adjustments to their order before it's shipped. Your customers can update their Actionable Date as needed, and our system will keep them in the loop with the adjusted reminder.

Q: Some of our subscriptions have not shipped, and we see Processing State "Failure" and Shipping State of "Address" what causes this?  More often than not, when a subscription fails, it is due to a failed payment, such as an expired credit card or even no funds available. We also suggest looking at the inventory since an Out Of Stock product will stop a subscription order from shipping.

Q: Is there a way to retry these subscription orders that have failed?





Q: We do not want subscription shipments to be inventory dependent, and having OOS products to stop subscriptions from shipping. What do you recommend?

We suggest having backorder setting turned ON. For more information about backorder, click on the link.

Suppose backorder is not an option you want to use. In that case, you can configure a subscription type to fulfill the order with a different variant if the scheduled variant is not available/error. So if Product B is out of stock, fulfill it with Product A. For more information about Subscription Type, please refer to this document  

Q: Can i create a Subscription from Chord OMS on behalf of my customer with Store Credit?

Yes, when you create a Subscription for an existing customer who has an existing payment on file. Select Stripe a Payment Method and Select the credit card on file as the Payment Source (see screenshot) - When the subscription will be generated, the Chord OMS will look for Store Credit, and if it exists it will deduct it from it



Do not worry if you see an Invalid Stripe payment transaction, it is how Chord OMS handles it, but no one is charged. (The breakdown of Store Credit is based on how the SC was accredited.



Q: Can i create a Subscription from Chord OMS on behalf of my customer using Stripe Invoice?

Yes, when you create a Subscription, select Stripe Invoice as Payment Method and do not select a Payment Source.



When the subscription order is created the

Navigate to Stripe and go to Payments --> Billing --> Invoices and search for the order number, or customer email address. Click Send Invoice. When your customer pays or however your business decides to handle Invoices you would still need to go back to Chord OMS and approve the payment.

Navigate to the Payments tab and click the Capture icon 👍

When captured, notice that your transaction is now Stripe invoice