Use Case: Add Custom-Priced Item Immediately

Assumptions and Preconditions

  • The subscription has the status Active.
  • All items in a subscription have the same billing interval.


  1. On March 15th, a client emails existing customers of its High-Frequency Trading subscription product. The email alerts customers that five new add-ons are now available at special introductory pricing.

  2. On March 16th, a customer clicks a link in the email and is redirected to a client-hosted landing page that uses the Get Subscription API endpoint to display details about their High-Frequency Trading subscription. The page also displays the following information regarding the five new add-ons:

    Click the checkbox next to each desired service

    Add-On Service Monthly Special Introductory Pricing!
    Service 1 $10

    Select any 3 services for $24.99/month ($8.33 each)

    Select any 4 services for $30/month ($7.50 each)

    Select all 5 services for $35/month ($7.00 each)

    Service 2 $10
    Service 3 $10
    Service 4 $10
    Service 5 $10
  3. The customer selects Service 1, Service 2, and Service 4, and clicks a "Calculate Prices" button on the page to view a preview of the amounts to be billed.

  4. The page uses the Add Subscription Item API endpoint to calculate the pro-rated price for the selected subscription items between March 16th and the subscription’s March 28th renewal date, and then displays the pro-rated price and renewal price to the customer:

    Pro-rated price for the 3 services selected (to be billed immediately): $11.66

    Renewal price for the 3 services selected (to be billed on March 28th): $24.99

  5. After reviewing this information, the customer confirms this purchase by clicking a "Buy Now" button on the page. The client's landing page uses the Add Subscription Item API endpoint to update the subscription details on the cleverbridge platform. The same day, the cleverbridge platform automatically bills the customer $11.66, the pro-rated cost of the added items for the remainder of the current billing interval.

  6. On March 28th, the customer's next billing date, the cleverbridge platform automatically bills the customer $124.99, which is the sum of $100 for High-Frequency Trading, $8.33 for Service 1, $8.33 for Service 2, and $8.33 for Service 4.


Although not utilized in this use case, the following option is also available:

  • Reduce the price of the selected subscription items by applying a discount coupon that was set up in the Commerce Assistant.


Obtain the customer's consent for changes to subscriptions. For more information, see Best Practices: Obtaining Customer Consent.


sub bill recs atem custom price immediate bill