Prepaid Subscriptions
Introduction
Chord OMS allows your customers to purchase multiple subscription installments upfront. This differs from regular subscriptions where customers are billed on an ongoing basis.
A prepaid subscription is created when a customer purchases a prepaid product (e.g., a 3-month subscription box for $90). The customer pays once, and the system fulfills installments according to the configured interval.
Key Differences from Regular Subscriptions
| Prepaid Subscription | Regular Subscription |
|---|---|---|
Payment | Upfront for all installments | Recurring per interval |
Duration | Fixed (e.g., 3 months) | Indefinite |
A prepaid subscription is a one-time payment and non-refundable order created by a customer for a predetermined number of subscription installment orders. The customer pays once for all of the subscription installmetn orders in advance.
Creating a Prepaid subscription via the Chord OMS API is similar to the creation of a standard subscription, with the addition of prepaid-specific attributes. Use the Create Order Line Item endpoint.
Key Subscriptions Attributes
- The subscription can be either a single item or a collection of items. If the subscription is a combination of several items you should create an overarching product that encapsulates the parts of the subscription. (Ex: The product image and name for this product will be the one used during checkout). This product must have a price of 0.
- Before adding to the cart you must capture the recipient's address and information before calling this endpoint.
- When the user adds this to the cart you must add the overarching product to the cart and fill in the prepaid_subscription object in options with the captured information along with the product information of the items in the box. All this is required is sku and quantity.
- state- Current state (pending, active, completed, canceled, inactive)
- installment_count- Number of installments included
- interval_length/interval_units- Fulfillment frequency (e.g., 1 month)
- gift- Whether this is a gift purchase
- auto_redeem - Automatic vs manual redemption
- redemption_method- For manual redemption: 'ship', 'email', or 'print'
- start_date - When fulfillment begins
- recurring- What happens after installments complete ('none', 'prepaid', 'subscription')
Example Request Payload
Prepaid Subscription in OMS Admin
Subscription Creation Order
Prepaid Subscription Details
Cancellation of a prepaid subscription can be handled via the Chord OMS Admin UI. Please documentation here.
Setup in OMS
There is currently no setup needed in the Chord OMS.