Welcome to Zuora Product Documentation

Explore our rich library of product information

Add optional charges to the subscribed hard bundle

Learn how to add optional charges to a subscribed hard bundle by configuring the rate plan and creating a new order using the updateProduct order action.

  1. Determine the values of the following variables and configure the hard bundle rate plan accordingly:

    Variable

    Description

    $Category

    The category. For example,NewSales.

    $existingAccountNumber

    The number of the account that will own the order and the subscription. For example,A00003063.

    $orderDate

    The date on which the order was created. For example, For example,2026-01-01.

    $subscriptionNumber

    The subscription number. For example A-S00007646 .

    $RatePlanId

    The ID of the subscription hard bundle rate plan to be updated. For example, edca2c537449baa531bbb198e11c034f .

    $productRatePlanChargeId

    The ID of the rate plan charge to include when adding the hard bundle rate plan. For example, 27ba5218ef0e4c43a51dd80b313ecb74

    .
  2. Refer to the example payload to create a new order with two optional component charge.

    Request

    POST /v1/orders/

    Request Body

    {
     "category": "NewSales",
     "existingAccountNumber": "$existingAccountNumber",
     "orderDate": "$orderDate",
     "subscriptions": [
       {
         "subscriptionNumber": "$subscriptionNumber",
         "orderActions": [
           {
             "type": "UpdateProduct",
             "updateProduct": {
               "ratePlanId": "$ratePlanId",
               "chargeOverrides": [
                 { "productRatePlanChargeId": "$productRatePlanChargeId" }
               ]
             },
             "triggerDates": [
               { "triggerDate": "2026-01-01", "name": "ContractEffective" },
               { "triggerDate": "2026-01-01", "name": "ServiceActivation" },
               { "triggerDate": "2026-01-01", "name": "CustomerAcceptance" }
             ]
           }
         ]
       }
     ]
    }
    
    

On the Subscription details page, the charges added by the Update Product order action are displayed in the Details column of the Subscription Change History section.

On the Orders details page, the charges added by the Update Product order action are displayed in the Order Actions tab in the Rate Plan and Charges section.