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

Too many immediate charges made in one hour

You've reached the hourly limit for immediate charges to this subscription.

Example response
{
"error": {
"type": "request_error",
"code": "subscription_immediate_charge_hour_limit_exceeded",
"detail": "You've exceeded the limit for the number of immediate charges that can be made to this subscription in an hour. Limit: 20 per hour",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_immediate_charge_hour_limit_exceeded"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
429
Error code
subscription_immediate_charge_hour_limit_exceeded
Error message
You've exceeded the limit for the number of immediate charges that can be made to this subscription in an hour. Limit: %d per hour

Common causes

  • You're trying to make a change to a subscription that results in an immediate charge, but your account has made too many immediate charges for this subscription in the last hour.

Troubleshooting

  • Wait an hour before making another change to this subscription which results in an immediate charge.
  • Retry the request with a proration_billing_mode of prorated_next_billing_period, full_next_billing_period to charge the customer on renewal, if compatible with the change you're making.
  • Retry the request with a proration_billing_mode of do_not_bill to avoid charging the customer, if compatible with the change you're making.
  • Contact the Paddle Seller Support team if you're not sure why you're being limited, or you're expecting a spike in traffic. Include the request_id with your message, if you received one.

Was this page helpful?