Prepaid to Recurring Subscription Conversion
With Chord Prepaid Subscriptions, operators have the ability to automatically have prepaid subscriptions convert to standard recurring subscriptions after the prepaid period is completed. The mechanism by which a prepaid subscription is converted to a recurring subscription is through the set-up and application of a promotion configured with a specific set of rules (more details below). NOTE: Assuming that prepaid subscription is configured to convert to recurring, at the completion of all of prepaid installments, the prepaid conversion will consist of the creation of a net-new recurring subscription which will be activated at the end of the prepaid duration. This is done this way for two reasons:
- The initial/original subscription is, for obvious reasons, considered a prepaid subscription. This subscription type is immutable and designed to be predefined.
- The new recurring subscription allows for flexibility and customization in the future in the event the customer would like to modify
Configuration
How to Create a Conversion Promotion
Navigate to your promotions page and create a New Promotion.
Once created, it is recommended that the promotion include these discount rules (though can vary by use-case):
- Order contains prepaid subscription
- Guarantees that only prepaid subscriptions will be targeted/eligible
- Has a Include gift prepaid subscrpitions toggle which can be turned on/off, depending on use-case need
- Subscription nth duration
- Allows for targeting of specific prepaid subscription duration/lengths
- Ex: Only allow prepaid subscriptions which are Weekly, have a interval length of 4 weeks and include 3 prepaid installments, to be eligible for conversion
NOTE: Remember to enable Always apply? to allow for OMS to attempt and check this promotion against all orders.

Once the discount rules are configured, the Convert prepaid to recurring subscription promotion adjustment type must be configured.

Example:

Validating Promotion on Order
When the promotion is succesfuly applied to an order, the convert_prepaid_to_subscription attribute should be present on order metadata and visible within the order admin UI.
If true,then we can expect that the Prepaid Subscription will be converted to a regular subscription once it completes its installments.

Managing Prepaid Subscriptions
Viewing a Prepaid Subscription
- Navigate to Prepaid Subscriptions in the OMS admin
- Click on any specific prepaid subscription to edit
- View all details in the sidebar (state, recurring type, gift status, etc.)
- View installment progress with visual indicators

Testing Prepaid Subscription Conversion
Generating Installments (Manually)
- In the sidebar, click "Generate installment" button
- OMS creates a new installment order
- Order needs to be manually completed
- Progress bar updates automatically

2/3 Installments Completed

3/3 Installments Completed

Completing Prepaid Subscriptions (Manually)
- When all installments are fulfilled and complete, the Complete prepaid subscription button is enabled
- Click the button to mark subscription as complete
- If the prepaid sub was originally eligible for the conversion promo, the subscription will convert to a recurring regular subscription


Should you have any questions or need further assistance, please do not hesitate to reach out to [email protected]!