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. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Subscription update is below the minimum charge amount

A subscription update must result in a chargeable amount above Paddle's minimum, or no charge at all.

Example response
{
"error": {
"type": "request_error",
"code": "subscription_update_transaction_balance_less_than_charge_limit",
"detail": "Unable to charge for Subscription update: Transaction balance is less than what we can charge. Transaction balance: 50, Minimum payment amount: 70, Currency code: USD",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_update_transaction_balance_less_than_charge_limit"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
subscription_update_transaction_balance_less_than_charge_limit
Error message
Unable to charge for Subscription update: %s

Common causes

  • The update results in a chargeable amount that's greater than zero but below the minimum Paddle can charge (around 70 US cents equivalent).
  • A discount lowered the total below the minimum but above zero.
  • Available credits lowered the balance below the minimum but above zero.

Troubleshooting

  • If you used a *_immediately proration_billing_mode, retry with the matching *_next_billing_period mode to defer the charge to renewal.
  • If you used a prorated_* proration_billing_mode, retry with the matching full_* mode to charge the full amount.

Was this page helpful?