---
title: "Update a product rate plan charge with Dynamic Pricing"
method: PUT
path: "/commerce/charges"
tags: ["Commerce"]
---

# Update a product rate plan charge with Dynamic Pricing

`PUT /commerce/charges`

Update an existing product rate plan charge (PRPC). Use this API to update default pricing and/or conditional rate cards.

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Request body

- UpdateChargeRequest
  - `charge` object, required — Fields to update on the product rate plan charge (PRPC). Only the properties provided will be considered for update (patch semantics). Unsupported updates are ignored by the service.
    - `chargeFunction` 'charge_function_standard' | 'charge_function_prepayment' | 'charge_function_commitment_true_up' | 'charge_function_drawdown' | 'charge_function_credit_commitment' | 'charge_function_drawdown_and_credit_commitment' — Function of the charge.
    - `prepaymentUnitType` 'unit' | 'currency' — Unit type used for the prepayment charge.
    - `id` string, required — Unique identifier of the product rate plan charge (PRPC) to update.
    - `name` string — Optional new display name for the charge.
    - `description` string — Optional new description for the charge.
    - `trigger_event` 'contract_effective' | 'service_activation' | 'customer_acceptance' — Event that triggers the charge (if update is supported).
    - `unit_of_measure` string — Unit of measure label for the charge, for example, Each, Seat. May be read-only in some tenants.
    - `default_quantity` number — Default quantity when the charge is added to a product/offer.
    - `min_quantity` number — Optional minimum quantity constraint (if supported).
    - `max_quantity` number — Optional maximum quantity constraint (if supported)
    - `list_price_base` string — List price basis (e.g., Per_Billing_Period). Typically read-only after creation.
    - `bill_cycle` object — Billing period configuration controlling frequency, alignment, and timing.
      - `type` string — Source of the default billing period, for example, default_from_customer, specific_day_of_month.
      - `day_of_month` integer — Day of month to bill when type = `specific_day_of_month`.
      - `day_of_week` string — Day of week to bill when using weekly modes.
      - `period` string — Billing period, for example, bill_cycle_period_month, bill_cycle_period_quarter.
      - `specific_period` string — Custom period text when applicable.
      - `period_alignment` string — Alignment behavior, for example, align_to_charge, align_to_term_start.
      - `timing` 'in_advance' | 'in_arrears' — Indicates whether billing occurs in advance or in arrears.
    - `pricing` union — Default (charge-level) pricing used when no rate-card row matches. Structure depends on the charge model: - flat_fee → flat_amounts - per_unit → unit_amounts - volume/tiered → tiers - discount_fixed_amount → discount_amounts - discount_percentage → discount_percentage
      - object
        - `flat_amounts` object, required — Map of currency to flat amount.
      - object
        - `unit_amounts` object, required — Map of currency to per-unit price.
      - object
        - `tiers` object[], required — Tier definitions (volume or tiered) with optional min/max caps.
          - `tier` string, required — Tier identifier, for example, "1", "2".
          - `from` number, required — Lower bound (inclusive).
          - `up_to` number, nullable — Upper bound (inclusive). Omit/null for open-ended last tier.
          - `price_format` string, required — For example, price_format_per_unit or price_format_flat_fee.
          - `unit_amounts` object — Per-unit price by currency for this tier.
          - `flat_amounts` object — Flat amount by currency for this tier (if applicable).
          - `min_amounts` object — Minimum billed amount by currency for this tier.
          - `max_amounts` object — Maximum billed amount by currency for this tier.
      - object
        - `discount_amounts` object, required — Map of currency to discount amount.
      - object
        - `discount_percentage` number, double, required — Discount percentage, for example, 15 for 15%.
    - `rate_cards` object[] — Conditional pricing rows (rate cards). Each row defines match attributes and a price to apply. If multiple rows match, the first match wins. If none match, `pricing` is used.
      - `attributes` object[], required — Match conditions that must all evaluate to true for the row to apply. Use `between` for ranges or dates.
        - `name` string, required — Attribute name, for example, Age, Region, EffectiveDate.
        - `operator` '>' | '>=' | '<' | '<=' | '==' | 'between' | 'between-inclusive' — Comparison operator.
        - `value` union — Comparison value. For `between`, provide an array of two values. The value type must align with the attribute’s declared type.
          - string
          - number
          - boolean
          - union[]
            - union
              - …
      - `pricing` union, required — Price to apply when this row matches. Structure mirrors `pricing` above.
        - object
          - `flat_amounts` object, required — Map of currency to flat amount.
        - object
          - `unit_amounts` object, required — Map of currency to per-unit price.
        - object
          - `tiers` object[], required — Tier definitions (volume or tiered) with optional min/max caps.
            - `tier` string, required — Tier identifier, for example, "1", "2".
            - `from` number, required — Lower bound (inclusive).
            - `up_to` number, nullable — Upper bound (inclusive).
            - `price_format` string, required — For example, price_format_per_unit.
            - `unit_amounts` object — Per-unit price by currency for this tier.
            - `flat_amounts` object — Flat amount by currency for this tier (if applicable).
            - `min_amounts` object — Minimum billed amount by currency for this tier.
            - `max_amounts` object — Maximum billed amount by currency for this tier.
        - object
          - `discount_amounts` object, required — Map of currency to discount amount.
        - object
          - `discount_percentage` number, double, required — Discount percentage (e.g., 15 for 15%).
    - `tax_code` string — Optional tax code to associate with the charge.
    - `tax_mode` string — Tax mode, for example, tax_exclusive, non_taxable, if supported.
    - `price_change_option` string — How price changes apply on updates, for example, no_change.
    - `use_tenant_default_for_price_change` boolean — If true, tenant defaults govern price change behavior.
    - `delivery_schedule` object — Day-of-week delivery configuration (if enabled).
    - `drawdown` object — Drawdown configuration for the charge when using prepaid with drawdown. Use this object to define the unit of measure used for drawdown consumption and the conversion rate applied during drawdown evaluation. **Note**: This field is only available if you have the Enhanced Unit-Based Prepaid with Drawdown feature enabled.
      - `unitOfMeasure` string — Unit of measure used for drawdown consumption. **Note**: This field is only available if you have the Enhanced Unit-Based Prepaid with Drawdown feature enabled.
      - `conversionRate` number, double — Conversion rate used when converting usage or rated amounts into the drawdown unit of measure. **Note**: This field is only available if you have the Enhanced Unit-Based Prepaid with Drawdown feature enabled.
    - `prepayment` object — Prepayment configuration for the charge, including credit, operation, quantity, validity period, rollover, and drawdown settings.
      - `creditOption` 'time_based' | 'consumption_based' | 'full_credit_back' | 'credit_option_unspecified' — How prepayment credits are applied (if supported).
      - `operationType` 'prepaid_operation_type_topup' — Type of prepayment operation.
      - `quantity` number, double — Number of units included in the prepayment charge.
      - `rollover` boolean — Whether unused prepayment funds roll over.
      - `rolloverApply` 'apply_first' | 'apply_last' — Specifies whether rollover funds are consumed before or after normal funds.
      - `rolloverPeriodLength` integer — Length of each rollover period.
      - `rolloverPeriods` integer — Number of rollover periods allowed.
      - `unitOfMeasure` string — Unit of measure for the prepayment charge.
      - `validityPeriod` 'subscription_term' | 'annual' | 'semi_annual' | 'quarter' | 'month' | 'specific_days' | 'specific_weeks' | 'specific_months' — Period during which prepayment units are valid. When enhanced unit-based Prepaid with Drawdown is enabled, specific days, specific weeks, and specific months are supported. When using a specific validity period, specify the `specificValidityPeriodLength` field.
      - `validityPeriodAlignment` 'vp_alignment_charge_start' | 'vp_alignment_term_start' | 'vp_alignment_term_end' — Alignment point used to determine the start of the validity period. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `validityPeriodProrationOption` 'vp_proration_option_prorate_units' | 'vp_proration_option_no_prorate' — Specifies whether the validity period is prorated. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `specificValidityPeriodLength` integer — Length of the validity period when a specific validity period is used. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `rolloverPeriodType` 'rollover_period_type_day' | 'rollover_period_type_month' | 'rollover_period_type_quarter' | 'rollover_period_type_annual' — Unit of time used for the rollover period. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `rolloverFundPriority` integer — Priority assigned to rolled-over funds. Lower values are consumed first. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `rolloverEndDateType` 'rollover_end_date_type_charge_end_date' | 'rollover_end_date_type_subscription_term' — Determines when rolled-over funds expire. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `fundSupportAccountHierarchy` boolean — Whether child accounts can consume drawdown funds from the parent account. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `drawdownPriority` integer — Priority used to determine the order in which drawdown funds are consumed. Lower values are consumed first. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
      - `drawdownScope` 'commitment_level_subscription' | 'commitment_level_account' — Scope at which drawdown funds are tracked and consumed. This field replaces the deprecated `commitmentLevel` field. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `prepaid` boolean — Indicates whether the charge is prepaid.
    - `overage_options` object — Overage configuration for usage charges.
    - `accounting` AccountingRequest — Accounting fields accepted on create/update requests. Field names use snake_case. **Conditional requirement rules** - If **Allow blank Accounting Codes** = **Yes** → Accounting fields are **optional**. - If **Allow blank Accounting Codes** = **No** and the tenant **has Zuora Revenue** → **all Accounting fields except `accounting_code` are required**. - If **Allow blank Accounting Codes** = **No** and the tenant **does NOT have Zuora Revenue** → only `recognized_revenue_account` and `deferred_revenue_account` are required. These rules apply to **all operations that accept `accounting`** in the payload.
      - `accounting_code` string — An accounting code associated with the charge for reporting/ERP mapping. Typically a short code or identifier, not the GL account name.
      - `accounts_receivable_account` string — Accounts Receivable (AR) account to book invoices for this charge. Must match an existing account in the tenant's chart of accounts.
      - `accounts_receivable_account_type` string — The account type associated with `accounts_receivable_account`. Maps to the `accountsReceivableAccountType` field in the accounting object.
      - `deferred_revenue_account` string — Deferred revenue (liability) account to book revenue before recognition. Must match an existing account in the tenant's chart of accounts.
      - `deferred_revenue_accounting_type` string — Accounting method/type applied to deferred revenue. Maps to the `deferredRevenueAccountingType` field in the accounting object.
      - `recognized_revenue_account` string — The name of the account where the Account Type is "Recognized Revenue".
      - `recognized_revenue_account_type` string — The account type associated with `recognized_revenue_account`. Maps to the `recognizedRevenueAccountType` field in the accounting object.
      - `adjustment_liability_account` string — The name of the account where the Account Type is "Adjustment Liability".
      - `adjustment_liability_account_type` string — The account type associated with `adjustment_liability_account`. Maps to the `adjustmentLiabilityAccountType` field in the accounting object.
      - `adjustment_revenue_account` string — The name of the account where the Account Type is "Adjustment Revenue".
      - `adjustment_revenue_account_type` string — The account type associated with `adjustment_revenue_account`. Maps to the `adjustmentRevenueAccountType` field in the accounting object.
      - `contract_asset_account` string — The name of the account where the Account Type is "Contract Asset".
      - `contract_asset_account_type` string — The account type associated with `contract_asset_account`. Maps to the `contractAssetAccountType` field in the accounting object.
      - `contract_liability_account` string — The name of the account where the Account Type is "Contract Liability".
      - `contract_liability_account_type` string — The account type associated with `contract_liability_account`. Maps to the `contractLiabilityAccountType` field in the accounting object.
      - `contract_recognized_revenue_account` string — Recognized revenue account used specifically for contract-based recognition flows. Must match an existing account in the tenant's chart of accounts.
      - `contract_recognized_revenue_account_type` string — The account type associated with `contract_recognized_revenue_account`. Maps to the `contractRecognizedRevenueAccountType` field in the accounting object.
      - `unbilled_receivables_account` string — The name of the account where the Account Type is "Unbilled Receivables".
      - `unbilled_receivables_account_type` string — The account type associated with `unbilled_receivables_account`. Maps to the `unbilledReceivablesAccountType` field in the accounting object.
    - `revenue` object — Revenue recognition settings (rule names, timing).
    - `netsuite` object — NetSuite integration attributes for the charge.
    - `custom_fields` object — Tenant-specific custom field values on the charge.
    - `labels` object — Free-form labels/tags attached to the charge.
    - `organization_labels` object[] — Organization-level labels associated with the charge.
    - `ocm_json_by_currency` object — Offer/OCM metadata keyed by currency (internal use).
    - `attributes` object[] — Attribute declarations for Dynamic Pricing (name/type/mapping).
      - `name` string, required — Attribute name, for example, Region, Age, EffectiveDate.
      - `type` 'string' | 'integer' | 'double' | 'boolean' | 'date' | 'datetime' — Attribute data type.
      - `mapping` object — Optional mapping to resolve values from Zuora objects.
        - `object` string, required — Target Zuora object, for example, account, subscription.
        - `field` string, required — Field on the target object, for example, age__c.

## Response `200`

OK

- CreateChargeResponse
  - `accounting` AccountingResponse — Accounting fields returned by the API. `*Type` fields are derived from the tenant's chart of accounts and are read-only.
    - `accountingCode` string — An accounting code associated with the charge for reporting or ERP mapping. Typically a short code or identifier, not the GL account name.
    - `accountsReceivableAccount` string — Accounts Receivable (AR) account to book invoices for this charge. Must match an existing account in the tenant's chart of accounts.
    - `accountsReceivableAccountType` string — System-derived type/category of the AR account from the chart of accounts. Examples include "AccountsReceivable".
    - `adjustmentLiabilityAccount` string — The name of the account where the Account Type is "Adjustment Liability".
    - `adjustmentLiabilityAccountType` string — System-derived type/category of the Adjustment Liability account from the chart of accounts. Examples include "AdjustmentLiability".
    - `adjustmentRevenueAccount` string — The name of the account where the Account Type is "Adjustment Revenue".
    - `adjustmentRevenueAccountType` string — System-derived type/category of the Adjustment Revenue account from the chart of accounts. Examples include "AdjustmentRevenue".
    - `contractAssetAccount` string — The name of the account where the Account Type is "Contract Asset".
    - `contractAssetAccountType` string — System-derived type/category of the Contract Asset account from the chart of accounts.
    - `contractLiabilityAccount` string — The name of the account where the Account Type is "Contract Liability".
    - `contractLiabilityAccountType` string — System-derived type/category of the Contract Liability account from the chart of accounts. Examples include "ContractLiability".
    - `contractRecognizedRevenueAccount` string — Recognized revenue account used specifically for contract-based recognition flows. Must match an existing account in the tenant's chart of accounts.
    - `contractRecognizedRevenueAccountType` string — System-derived type/category of the Contract Recognized Revenue account from the chart of accounts.
    - `deferredRevenueAccount` string — Deferred revenue (liability) account to book revenue before recognition. Must match an existing account in the tenant's chart of accounts.
    - `deferredRevenueAccountType` string — System-derived type/category of the Deferred Revenue account from the chart of accounts.
    - `recognizedRevenueAccount` string — The name of the account where the Account Type is "Recognized Revenue".
    - `recognizedRevenueAccountType` string — System-derived type/category of the Recognized Revenue account from the chart of accounts.
    - `unbilledReceivablesAccount` string — The name of the account where the Account Type is "Unbilled Receivables".
    - `unbilledReceivablesAccountType` string — System-derived type/category of the Unbilled Receivables account from the chart of accounts.
    - `productRatePlanChargeId` string — The ID of your product rate plan charge.
  - `attributes` object[] — Attribute metadata associated with Dynamic Pricing for this charge.
  - `billCycle` object
    - `dayOfMonth` integer — Specific day of month to bill when type = specific_day_of_month.
    - `period` string — Billing period length.
    - `periodAlignment` string — How the billing period start aligns.
    - `timing` string — Whether the charge bills before or after the service period.
    - `type` string — Bill-cycle mode (inherit defaults or set specific day rules).
  - `chargeFunction` 'charge_function_standard' | 'charge_function_prepayment' | 'charge_function_commitment_true_up' | 'charge_function_drawdown' | 'charge_function_credit_commitment' | 'charge_function_drawdown_and_credit_commitment' — Internal function/category of the charge used by rating.
  - `chargeModel` string — Pricing model that determines how the amount is calculated.
  - `chargeType` string — Whether the charge recurs, rates usage, or is a one-time fee.
  - `createdById` string — User ID that created the charge record.
  - `createdTime` string, date-time — Timestamp when the charge record was created.
  - `customFields` object — Tenant-specific custom field values on the charge.
  - `deliverySchedule` object — Day-of-week delivery settings when delivery scheduling is enabled.
    - `frequency` string — Delivery frequency label for schedule rules.
    - `friday` boolean — Deliver on Friday.
    - `monday` boolean — Deliver on Monday.
    - `saturday` boolean — Deliver on Saturday.
    - `sunday` boolean — Deliver on Sunday.
    - `thursday` boolean — Deliver on Thursday.
    - `tuesday` boolean — Deliver on Tuesday.
    - `wednesday` boolean — Deliver on Wednesday.
  - `discountOptions` object — How discount charges apply and interact with other discounts.
    - `applyDetails` object[] — Per-target discount application details (if populated).
    - `applyTo` string[] — Which components or charges the discount applies to.
    - `applyToBillingPeriodPartially` boolean — Whether the discount duration can partially align to a period.
    - `reflectDiscountInNetAmount` boolean — Whether discounts reduce the net amount on invoices.
    - `rollover` boolean — Whether unused discount can roll over to future periods.
    - `stackedDiscount` boolean — Whether this discount stacks with other discounts.
  - `drawdown` object — Drawdown configuration for the charge when using prepaid with drawdown.
    - `unitOfMeasure` string — Unit of measure used for drawdown consumption. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `conversionRate` number, double — Conversion rate used when converting usage or rated amounts into the drawdown unit of measure. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
  - `endDateCondition` string — Rule for when the charge ends.
  - `upToPeriodsType` string — Unit used for the fixed period when `endDateCondition` is `fixed_period`, for example, billing periods or days.
  - `upToPeriods` integer — Number of periods, in units of `upToPeriodsType`, that the charge remains active when `endDateCondition` is `fixed_period`.
  - `extendedPrice` object — Calculated extended price details (model-dependent).
  - `id` string — Unique identifier of the product rate plan charge (PRPC).
  - `isChargeLevelMinCommit` boolean — Whether a minimum commit is enforced at the charge level.
  - `isCommitted` boolean — Indicates if the charge definition is committed/finalized.
  - `labels` object — Free-form labels/tags attached to the charge.
  - `listPriceBase` string — List price basis, for example, Per Billing Period, Per Month, Per Year.
  - `specificListPriceBase` integer — The number of months for the list price base of the charge. This field is required when the `ListPriceBase` field is set to `Per Specific Months`. The value must be a positive integer between **1** and **120**, inclusive. **Notes**: - This field is available only if you have the Annual List Price feature enabled. - To use this field, you must set the `X-Zuora-WSDL-Version` request header to `129` or later. - The value of this field is `null` if you do not set the value of the `ListPriceBase` field to `Per Specific Months`.
  - `mergedRateCards` object[] — Effective rate-card rows after merges (if any).
  - `name` string — Display name of the charge in the plan.
  - `negotiatedRateCards` object[] — Customer- or deal-specific rate-card rows applied by negotiation.
  - `netsuite` object — NetSuite integration attributes mapped for this charge.
  - `ocmJsonByCurrency` object — Offer/OCM metadata keyed by currency (internal use).
  - `organizationLabels` string[] — Organization-level labels associated with the charge.
  - `overageOptions` object — Overage settings for usage charges.
    - `includedUnits` number — Included units before overage starts.
    - `unusedUnitsCreditRates` object — Credit rates for unused units (by currency).
  - `prepaid` boolean — Indicates whether the charge is prepaid.
  - `prepaymentUnitType` 'unit' | 'currency' — Unit type used for the prepayment charge.
  - `prepayment` object — Prepayment configuration for the charge, including credit, operation, quantity, validity period, rollover, and drawdown settings.
    - `creditOption` 'time_based' | 'consumption_based' | 'full_credit_back' | 'credit_option_unspecified' — How prepayment credits are applied (if supported).
    - `operationType` 'prepaid_operation_type_topup' — Type of prepayment operation.
    - `quantity` number, double — Number of units included in the prepayment charge.
    - `rollover` boolean — Whether unused prepayment funds roll over.
    - `rolloverApply` 'apply_first' | 'apply_last' — Specifies whether rollover funds are consumed before or after normal funds.
    - `rolloverPeriodLength` integer — Length of each rollover period.
    - `rolloverPeriods` integer — Number of rollover periods allowed.
    - `unitOfMeasure` string — Unit of measure for the prepayment charge.
    - `validityPeriod` 'subscription_term' | 'annual' | 'semi_annual' | 'quarter' | 'month' | 'specific_days' | 'specific_weeks' | 'specific_months' — Period during which prepayment units are valid. When enhanced unit-based Prepaid with Drawdown is enabled, specific days, specific weeks, and specific months are supported. When using a specific validity period, specify the `specificValidityPeriodLength` field.
    - `validityPeriodAlignment` 'vp_alignment_charge_start' | 'vp_alignment_term_start' | 'vp_alignment_term_end' — Alignment point used to determine the start of the validity period. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `validityPeriodProrationOption` 'vp_proration_option_prorate_units' | 'vp_proration_option_no_prorate' — Specifies whether the validity period is prorated. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `specificValidityPeriodLength` integer — Length of the validity period when a specific validity period is used. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `rolloverPeriodType` 'rollover_period_type_day' | 'rollover_period_type_month' | 'rollover_period_type_quarter' | 'rollover_period_type_annual' — Unit of time used for the rollover period. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `rolloverFundPriority` integer — Priority assigned to rolled-over funds. Lower values are consumed first. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `rolloverEndDateType` 'rollover_end_date_type_charge_end_date' | 'rollover_end_date_type_subscription_term' — Determines when rolled-over funds expire. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `fundSupportAccountHierarchy` boolean — Whether child accounts can consume drawdown funds from the parent account. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `drawdownPriority` integer — Priority used to determine the order in which drawdown funds are consumed. Lower values are consumed first. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
    - `drawdownScope` 'commitment_level_subscription' | 'commitment_level_account' — Scope at which drawdown funds are tracked and consumed. This field replaces the deprecated `commitmentLevel` field. **Note**: This field is only available if you have the enhanced unit-based Prepaid with Drawdown feature enabled.
  - `priceChangeOption` string — How price changes are applied across renewals/amendments.
  - `pricing` object — Default (charge-level) price configuration by model/currency.
    - `adjustments` object — Price adjustments metadata.
    - `discountAmounts` object — Fixed discount amounts by currency.
    - `discountPercentages` object — Percentage discount values by currency.
    - `flatAmounts` object — Flat amounts by currency for flat-fee pricing.
    - `maxAmounts` object — Maximum caps by currency.
    - `minAmounts` object — Minimum charges by currency.
    - `percentages` object — Percentage price values by currency (model-dependent).
    - `tiers` object[] — Tier definitions for tiered/volume pricing.
    - `unitAmounts` object — Per-unit amounts by currency for per-unit/usage pricing.
  - `pricingSummary` string[] — Human-readable price summary strings, for example, USD100.
  - `pricingWaterfalls` object — Detailed pricing/waterfall breakdown (if available).
  - `productChargeDefinitions` object[] — Underlying charge definitions referenced for pricing lookup.
  - `productRatePlanChargeNumber` string — PRPC number.
  - `productRatePlanId` string — ID of the plan (PRP) that owns this charge.
  - `prorationOption` string — How proration is handled relative to tenant defaults.
  - `rateCards` object[] — Dynamic Pricing rate-card rows configured on the charge.
  - `revenue` object — Revenue policy settings for this charge.
    - `excludeItemBillingFromRevenueAccounting` boolean — If true, item billing is excluded from revenue accounting.
    - `excludeItemBookingFromRevenueAccounting` boolean — If true, item booking is excluded from revenue accounting.
    - `legacyReporting` boolean — Indicator for legacy revenue reporting behaviors.
    - `revenueRecognitionRuleName` string — Name of the revenue rule to apply, for example, "Recognize upon invoicing".
  - `taxCode` string — Tax code applied to the charge (for example, a tax category code).
  - `taxMode` string — Tax mode for the charge.
  - `taxable` boolean — Whether the charge is taxable.
  - `triggerEvent` string — Event that triggers the charge.
  - `unitOfMeasure` string — Unit of measure used for pricing (for example, Each, Seats).
  - `updatedById` string — User ID that last updated the charge record.
  - `updatedTime` string, date-time — Timestamp when the charge record was last updated.
  - `useTenantDefaultForPriceChange` boolean — Whether tenant defaults govern price change behavior.

## Other responses

- `400` — Request Errors or Unauthorized
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-08-08** `7f43d4a77e8a` — 12 warning, 38 info
  - added the new `apply_first` enum value to the `prepayment/rolloverApply` response property for the response status `200`
  - added the new `apply_last` enum value to the `prepayment/rolloverApply` response property for the response status `200`
  - added the new `charge_function_commitment_true_up` enum value to the `chargeFunction` response property for the response status `200`
  - added the new `charge_function_credit_commitment` enum value to the `chargeFunction` response property for the response status `200`
  - …46 more

[Change history](https://skmtc.dev/zuora/apis/api-reference/changes/commerce/charges/put.md)

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/702f3caf3985/schema)