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 prepaid subscription regular 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 https //chord stoplight io/docs/chord oms/f5ca7f8c0c368 create order line item 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 { "line item" { "variant id" 123, "quantity" 1 }, "prepaid subscription" { "quantity" 1, "single installment price" "29 99", "amount" "89 97", "installment count" 3, "auto redeem" true, "actionable date" "2025 02 01", "recurring" "none", "interval" { "length" 1, "units" "month" }, "line items" \[ { "sku" "subscription box 001", "quantity" 1 } ] } } 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 https //docs chord co/oms/cancellation of prepaid subs setup in oms there is currently no setup needed in the chord oms