--- title: Prepaid Subscriptions slug: oms/prepaid-subscriptions docTags: createdAt: 2025-11-24T12:24:59.698Z --- ## 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. :::hint{type="info"} 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](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** :::BlockQuote \{ "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 ![](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/L2D8xpXD6DEvWZgFoiTv9_image.png) ### Prepaid Subscription Details ![](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/NCou9QFu8fbJokw1tY5JA_image.png) :::hint{type="danger"} Cancellation of a prepaid subscription can be handled via the Chord OMS Admin UI. Please [documentation here. ](https://docs.chord.co/oms/cancellation-of-prepaid-subs) ::: ## Setup in OMS There is currently no setup needed in the Chord OMS. ### ###