For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Price has duplicate allowances for a usage balance unit

A price can have only one allowance for each usage balance unit, but `allowances` includes the same `usage_balance_unit_id` more than once.

Join usage-based billing early access (beta)

Usage-based billing is in early access (beta). Read how it works, then apply to join. We'll reach out if you meet the program requirements.

Example response
{
  "error": {
    "type": "request_error",
    "code": "price_allowance_duplicate_usage_balance_unit",
    "detail": "usage balance unit ubu_01kw8ta2j8x5t7q4v9m1kd6phz appears more than once in allowances",
    "documentation_url": "https://developer.paddle.com/errors/prices/price_allowance_duplicate_usage_balance_unit"
  },
  "meta": {
    "request_id": "00000000-0000-0000-0000-000000000000"
  }
}

Details

Status code
400
Error code
price_allowance_duplicate_usage_balance_unit
Error message
usage balance unit %s appears more than once in allowances

Common causes

  • Two or more entries in allowances have the same usage_balance_unit_id.
  • When updating a price, allowances replaces the existing allowances in full. The request adds a new entry for a usage balance unit that's already in the list, instead of changing the amount on the existing entry.

Troubleshooting

  • Combine the duplicate entries into one allowance, with amount set to the total amount of the usage balance unit that the price should grant each billing period.
  • If one of the entries is meant for a different usage balance unit, correct its usage_balance_unit_id.
See all errors

Was this page helpful?