Use Case: Make Quantity and Quantity-Based Price Changes Immediately

Assumptions and Preconditions

  • The subscription has the status Active.


  1. On April 7th, a client emails customers whose subscriptions include 10 user accounts or less with a special offer to increase the number of user accounts at volume discount prices.

  2. On April 11th, a customer, who currently pays 15€ monthly for 10 user accounts, clicks on the “Buy Now” link in the promotional email and is redirected to a landing page that displays the following price table:

    Total User


    New Monthly Price

    per User Account

    20 – 49 10€
    50 – 99 7.50€
    100 or more 5€
  3. The customer decides to purchase 30 additional user accounts, for a total of 40. They enter 40 in an entry field below the table and click a “Calculate Prices” icon on the page.

  4. The page uses the Update Subscription Item Price API endpoint to calculate the pro-rated price between the current date and the May 1st renewal date for the 30 additional user accounts. The page also calculates the renewal price and then displays the following to the customer:

    Pro-rated price for 30 user accounts (to be billed immediately): 200€

    Renewal price for 40 user accounts (to be billed on February 2): 400€

  5. After reviewing this information, the customer confirms that they want to proceed. The page uses the Update Subscription Item Price API endpoint to update the user account quantity and price on the cleverbridge platform. The cleverbridge platform automatically bills the pro-rated price for 30 additional user accounts for the remainder of the current billing interval.

  6. On May 1st, the cleverbridge platform automatically bills the customer 400€ for the next monthly billing interval.


sub bill change props change qty based price immediately