Add Ons and Discounts

Occasionally, you might wish to modify a Subscription with either a Discount or an Add On without creating a new Plan that has limited use. A Discount reduces the recurring amount for one or more payments, while an Add On increases the payments in return for an added service or item. You can apply either of these payment modifications at the time you initialize the Subscription or anytime afterward by updating the Subscription. In both cases you define the start date, end date, and amount of the Discount/Add On.

For example, suppose as part of your standard offering, your customers received 2GB of cloud-based storage. You also offer additional storage in 2GB blocks for $10 each. One of your customers wants an additional 4GB of storage for the 8 months remaining on his contract and you are discounting the first month at 50%, or $10. The example below show the updateSubscription transaction with the Add On and Discount.

Example:  Update Subscription with Discount and Add On

<updateSubscription>

  <subscriptionId>1234</subscriptionId>

  <createDiscount>

    <discountCode>4GBExtraDeal</discountCode>

    <name>Half-Off 1st Payment 4GB Extra</name>

    <amount>1000<amount>

    <startDate>2016-09-15</startDate>

    <endDate>2016-10-14</endDate>

  </createDiscount>

  <createAddOn>

    <addOnCode>4GB_Extra</addOnCode>

    <name>Four_GB_Extra</name>

    <amount>2000<amount>

    <startDate>2016-09-15</startDate>

    <endDate>2016-04-15</endDate>

  </createAddOn>

</updateSubscription>