Skip to main content
The subscription is on a balance plan, and its balance is in the currency it pays, so a version move cannot charge it in USD.
  • Error type: billing_error
  • code: currency_held_by_balance_plan
  • API version: 2026-08-27

What to do

Keep the subscription on its version. The response message, param, and details fields describe the condition observed by the specific operation.

Retry behavior

Retry with currency usd once the reason no longer applies; a scheduled move that meets it at renewal is canceled with this code as its reason.

Correlate the request

Keep the x-request-id response header when reporting or investigating this error. Platform records the same identifier in its request event, so Commet can locate the exact execution without customer data or credentials.