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

Transaction balance is below the minimum charge

The transaction's balance is greater than zero but below the minimum amount Paddle can charge for its currency.

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

Details

Status code
400
Error code
transaction_balance_less_than_charge_limit
Error message
Transaction balance is less than what we can charge. Transaction balance: %d, Minimum payment amount: %d, Currency code: %s

Common causes

  • The transaction total is greater than 0 but below the minimum chargeable amount for its currency (for example, 70 cents USD).
  • A discount reduced the balance to below the minimum chargeable amount but above zero.
  • Available credits reduced the balance to below the minimum chargeable amount but above zero.

Troubleshooting

  • Increase the transaction total so the amount to be charged is at or above the minimum for its currency.
  • A zero-balance transaction is allowed; the minimum only applies when there's an amount to charge.

Was this page helpful?