home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Product update in subscriptions

Update a rate plan with selective charges using REST API

Learn how to update a rate plan by adding selective charges using the Create an order operation.

You can use the Create an order operation to update a rate plan with selective charges.

  1. Determine the values of the following variables:

    Variable

    Description

    productRatePlanChargeId

    The ID of the product rate plan charge. For example, 402880e78cd84081018cd85d8d32001f.

    RatePlanId

    The ID of the subscription rate plan rate plan. For example, 402880e48d15c3a8018d15cfe49d00ab.

  2. Use the following code for updating a subscription rate plan by adding selective charges. For example, consider that you want to add one remaining charge with productRatePlanChargeId to an existing subscription rate plan with ratePlanId.
    Note: This operation is possible only if this charge hasn’t been added to this subscription rate plan earlier.

    Request

    POST /v1/orders/

    Request Body

    		 
    {
    "orderDate": "2024-01-01",
    "existingAccountNumber": "AN_acc17031289013921703128901395",
    "subscriptions": [
        {
            "subscriptionNumber": "A-S00000021",
            "orderActions": [
                {
                    "type": "UpdateProduct",
                    "triggerDates": [
                        {
                            "triggerDate": "2024-01-01",
                            "name": "ContractEffective"
                        },
                        {
                            "triggerDate": "2024-01-01",
                            "name": "ServiceActivation"
                        },
                        {
                            "triggerDate": "2024-01-01",
                            "name": "CustomerAcceptance"
                        }
                    ],
                    "updateProduct": {
                        "ratePlanId": "402880e48d15c3a8018d15cfe49d00ab",
                        "isAddingSubsetCharges": true,
                        "chargeUpdates": [
                            {
                                "productRatePlanChargeId": "402880e78cd84081018cd85d8d32001f"
                            }
                        ]
                    }
                }
            ]
        }

In the above example, you can mention productRatePlanChargeNumber instead of productRatePlanChargeId to specify the charge.

This feature is in the Early Adopter phase. We are actively soliciting feedback from a small group of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at Zuora Global Support.

Last updated: March 30, 2026