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

Recurring balance is below the minimum charge

The recurring amount on the transaction is below the minimum Paddle can charge for its currency.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_recurring_balance_less_than_charge_limit",
"detail": "Transaction recurring balance will be less than what we can charge. Recurring balance: 10, Minimum payment amount: 70, Currency code: USD",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_recurring_balance_less_than_charge_limit"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_recurring_balance_less_than_charge_limit
Error message
Transaction recurring balance will be less than what we can charge. Recurring balance: %d, Minimum payment amount: %d, Currency code: %s

Common causes

  • The total of the recurring prices (prices with a billing_cycle) is below the minimum chargeable amount for its currency (for example, 70 cents USD).
  • One-off and recurring prices combine to meet the minimum for the initial charge, but the recurring charge on its own falls below the minimum.

Troubleshooting

  • Make sure both the initial charge and the recurring charge are at or above the minimum for the transaction's currency.

Was this page helpful?