> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/chord-oms/chord-oms-overview/subscriptions/prepaid-subscriptions.md).

# 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.

{% hint style="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).
{% endhint %}

### 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**

{% hint style="info" %}
{ "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 } ] } }
{% endhint %}

## Prepaid Subscription in OMS Admin

### Subscription Creation Order

![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-b79729ae7cadc620f0deba134cc80403340280ee%2Fprepaid-subscriptions-1.png?alt=media)

### Prepaid Subscription Details

![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-2c319fb9267e56a2f9d76fabb3887389ebda6e0c%2Fprepaid-subscriptions-2.png?alt=media)

{% hint style="danger" %}
Cancellation of a prepaid subscription can be handled via the Chord OMS Admin UI. Please [documentation here.](/chord-oms/chord-oms-overview/subscriptions/prepaid-subscriptions/cancellation-of-prepaid-subs.md)
{% endhint %}

## Setup in OMS

There is currently no setup needed in the Chord OMS.

###

###


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chord.co/chord-oms/chord-oms-overview/subscriptions/prepaid-subscriptions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.