update_product_rate_plan_charge
Update a product rate plan charge by submitting only the fields you want to change, such as price or billing period. The tool merges your input with existing charge data and validates before calling the API.
Instructions
Update a product rate plan charge. PUT /product-rateplan-charges/{chargeId}. You can send only the fields you want to change (e.g. chargeTier with new price); the tool fetches the current charge and merges your input so the backend receives all required fields. Validates in MCP before calling the API. Optional inputs: name, chargeType, chargeModel, billCycleType, category, chargeTier (currency, price as dollars e.g. 22.87 or cents e.g. 2287), taxable, weight, endDateCondition, billingPeriod, billingTiming, billingPeriodAlignment, specificBillingPeriod, billCycleDay (1-31 when billCycleType specificDayOfMonth), weeklyBillCycleDay (when specificDayOfWeek), monthlyBillCycleYear (1-12 when specificMonthOfYear). When chargeType is recurring, billingPeriod, specificBillingPeriod, billingPeriodAlignment, billingTiming are required.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chargeId | Yes | Product rate plan charge ID (required) | |
| name | No | Charge name | |
| chargeType | No | oneTime, recurring, or usage | |
| chargeModel | No | flatFeePricing, perUnitPricing, tieredPricing, or volumePricing | |
| billCycleType | No | chargeTriggerDay, defaultFromCustomer, specificDayOfMonth, specificDayOfWeek, specificMonthOfYear, subscriptionStartDay, subscriptionFreeTrial | |
| category | No | physical or digital | |
| chargeTier | No | Array of {currency, price (dollars e.g. 22.87 or cents e.g. 2287), optional startingUnit, endingUnit, priceFormat, tier}. To update only price, send this and chargeId; other fields are filled from current charge. | |
| taxable | No | Whether taxable | |
| weight | No | Weight (integer) | |
| description | No | Description | |
| endDateCondition | No | subscriptionEnd or fixedPeriod | |
| billingPeriod | No | day, week, month, or year (required if chargeType recurring) | |
| billingTiming | No | inAdvance or inArrears (required if chargeType recurring) | |
| billingPeriodAlignment | No | alignToCharge, alignToSubscriptionStart, alignToTermStart (required if chargeType recurring) | |
| specificBillingPeriod | No | Required when chargeType recurring | |
| billCycleDay | No | 1-31 when billCycleType is specificDayOfMonth | |
| weeklyBillCycleDay | No | sunday, monday, tuesday, wednesday, thursday, friday, saturday when billCycleType is specificDayOfWeek | |
| monthlyBillCycleYear | No | 1-12 when billCycleType is specificMonthOfYear |