How to Manage Prepaid Renewal Behaviors

Each prepaid subscription has a renewal behavior that will control what will happen when all prepaid orders are placed. Those are:

• autorenew: Renew and bill the customer a full prepaid cycle after all orders are placed. The renewal happens when the first order of the next cycle is placed.
• cancel: When all orders are placed the subscription is cancelled. Customers can reactivate it to start a new prepaid cycle
• downgrade: Turns the prepaid subscription to a normal subscription when all orders are placed. The next order placed for the subscription will have the price of a single shipment.

All subscriptions will be created using the default renewal behavior, which is autorenew. The default renewal behavior can be changed if you want your customers to have their prepaid subscriptions canceled or downgraded to normal subscriptions at the end of their cycles. In case you want to change the default renewal behavior of your store please contact us at [email protected].

You can also create specific subscriptions with a custom renewal behavior

How to Create Subscription with Custom Prepaid Renewal Behavior

Shopify

To specify which custom renewal behavior you want when checking out with a prepaid item, a property needs to be added to the line item. This property's name is: __og_prepaid_subscription_renewal_behavior and the value can be any of the valid renewal behaviors.

You can add this line item property following Shopify Cart API or by adding this value to the product form on the product page.

This is an example of how an input can be used to set the custom renewal behavior:

<input type="hidden" name="properties[__og_prepaid_subscription_renewal_behavior]" value="cancel">

Other platforms

When creating the subscription through the Purchase Post API the renewal behavior can be controlled in products[].subscription_info.renewal_behavior field.