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

Manually-collected subscriptions can't have prices with allowances

Subscriptions with an item whose price has `allowances` must have `collection_mode` set to `automatic`.

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": "subscription_manual_allowance_not_allowed",
"detail": "This subscription is collected manually and has recurring items where the price has allowances, which isn't allowed.",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_manual_allowance_not_allowed"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
subscription_manual_allowance_not_allowed
Error message
This subscription is collected manually and has recurring items where the price has allowances, which isn't allowed.

Common causes

  • The request sets collection_mode to manual, and the subscription has an item whose price has allowances.
  • The request updates items on a subscription that's collected manually, and one or more of the items have a price with allowances.

Troubleshooting

  • Keep collection_mode set to automatic for subscriptions with items whose price has allowances.
  • Remove the items whose price has allowances, or replace them with items whose price doesn't have allowances.
  • Remove allowances from the price, then try your request again.

Was this page helpful?