Update prepayment product in subscription

Overview

After you have created a prepayment subscription through Orders, you can update prepayment charges in the existing subscription for your customers.  

Suppose your customer has subscribed to the following product for 12 months:

After a while, your customer wants to increase the prepaid units from 10 to 20 because of increased businesses. You can do this for your customer through the Zuora UI or REST API. 

Zuora UI

Follow the steps described in Update a product in a subscription.

Select the desired product to be updated in this order. 

Update the charge details as needed. 

• You can update Price and Prepaid Quantity of prepayment charge. 
• See the Notes and limitations section for things to consider when updating prepayment products. 

REST API

Use the Create an order operation to update the prepaid charge in a subscription. 

Determine the value of theprepaidQuantityfield specific to the prepayment charge to be updated.

Sample request body: Update the prepaid quantity in a subscription from 10 to 20. 

...
"orderActions": [
       {
         "type": "UpdateProduct",
         "updateProduct": {
           "ratePlanId": "4028818c7dc31247017dc36f40430113",
           "chargeUpdates": [
             {
               "chargeNumber": "C-00000014",
               "prepaidQuantity": 20
             }
           ]
         }
       }
     ]

Once the order action is activated, for the remaining validity periods in the subscription term, the customer is granted 20 Million API calls valid to use each month on a use-it-or-lose-it basis. The prepaid total quantity is recalculated. 

You can view the customer’s prepaid balance through the Zuora UI or Data Query. 

Notes and limitations

• Only list price and prepaid quantity of prepayment charges can be updated. The prepaid quantity must be a positive number. 
• An update is only allowed at the beginning of a validity period. For example, a prepayment charge in the original 12-month subscription has 4 quarterly validity periods: 
  • 01/01/2022-03/31/2022
  • 04/01/2022-05/31/2022
  • 06/01/2022-09/30/2022
  • 10/01/2022-12/31/2022

You can only update this prepayment charge on 01/01/2022, 04/01/2022, 06/01/2022, or 10/01/2022.