Transaction for a subscription has more than the maximum number of line items

{
  "error": {
    "type": "request_error",
    "code": "subscription_maximum_number_of_line_items_reached",
    "detail": "Subscription update results in a transaction that has more than the maximum number of line items.",
    "documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_maximum_number_of_line_items_reached"
  },
  "meta": {
    "request_id": "00000000-0000-0000-0000-000000000000"
  }
}

Details

Status code

400

Error code

subscription_maximum_number_of_line_items_reached

Error message

Subscription update results in a transaction that has more than the maximum number of line items.

Common causes

• You're trying to add more than 100 recurring items to a subscription.
• You're billing for changes on the next billing period, but there are already line items for previous changes or one-time charges scheduled to be billed on renewal. This results in the next transaction including more than 100 line items.
• You're replacing too many recurring items on a subscription in one go, resulting in the next transaction including more than 100 line items.

Troubleshooting

• Reduce the number of recurring items on the subscription to 100 or fewer.
• Get a subscription including next_transaction to preview line items for the next transaction, including subscription changes and one-time charges that are scheduled to be billed.
• Use prorated_immediately or full_immediately as the proration_billing_mode to bill for changes immediately rather than adding them to the transaction created on renewal.