Docs

Invalid billing mode when updating subscription with scheduled change

Subscriptions with a scheduled pause or cancel can only be updated with a supported `proration_billing_mode`

Example response
{
"error": {
"type": "request_error",
"code": "subscription_invalid_billing_mode_for_scheduled_change",
"detail": "Subscription can only be updated with `do_not_bill`, `full_immediately`, or `prorated_immediately` as the `proration_billing_mode` because it has a scheduled change.",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_invalid_billing_mode_for_scheduled_change"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
subscription_invalid_billing_mode_for_scheduled_change
Error message
Subscription can only be updated with `do_not_bill`, `full_immediately`, or `prorated_immediately` as the `proration_billing_mode` because it has a scheduled change.

Common causes

  • You're trying to update a subscription that has a scheduled change using a proration_billing_mode that bills on the next billing period, which isn't allowed.

Troubleshooting

  • Use do_not_bill, full_immediately, or prorated_immediately for the proration_billing_mode.
  • Remove the scheduled change to use any proration_billing_mode.

Was this page helpful?