> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable Subscribers to Upgrade Subscriptions with Promotional Rate

You can enable your subscribers to upgrade their existing subscriptions to superior subscriptions (as defined by you) at a promotional rate using your self-care portal, with the upgrade taking effect immediately. To support this functionality, you must use the Subscribe APIs.

* **Use Case Number:** 2-4-12
* **Completed By:** Software Developer
* **Estimated Completion Time:** \<1 day

## Basic Scenario

The Subscriber logs in to your self-care portal and enters a promotional code to upgrade their subscription at a discount. The subscriber's existing Subscription must be in Good Standing or in Soft or Hard Error, and the Subscription end date must not be in the past.

## Design Approach

As shown in the following diagram, you must post the change and campaign code to the subscription endpoint, indicating which products/items on the subscription are to be replaced, and optionally providing a new billing plan if the billing frequency is also going to change.

If the upgrade fails due to an inability to collect the funds, you must request a new payment method using PMT and resubmit the subscription upgrade with promotion using a new payment method.

<img src="https://mintcdn.com/amdocs-slm/ifa3y22T11JlqvtT/portal/vindiciaSubscribeAndNewRetain/subscribeUseCases/images/2412_upgradeSubscriptionWithPROMOImmediateEffect.png?fit=max&auto=format&n=ifa3y22T11JlqvtT&q=85&s=4cd299a6fa1ac14e2c6b4764929060f9" alt="" width="931" height="483" data-path="portal/vindiciaSubscribeAndNewRetain/subscribeUseCases/images/2412_upgradeSubscriptionWithPROMOImmediateEffect.png" />

* **[Upgrade Subscriptions with Promotional Rate Using Subscribe APIs](../topics/2412_r_upgradeSubscriptionsPromo#)**

**Parent topic:**[Subscription Upgrades & Downgrades](../topics/r_subscriptionUpgradesDowngrades)

## Upgrade Subscriptions with Promotional Rate Using Subscribe APIs

Set up a promotional rate for the upgrade (see [Set Up Promotional Pricing](2109_r_offerPromotionalPricing#)).

To enable subscribers to upgrade Subscriptions with promotional rates:

1. POST the subscription change to the subscriptions endpoint.

   **Sample Code:**

   [https://github.com/Vindicia/CashBoxRESTCodeSamples/blob/master/Autobill/subscription\_modify\_monthly\_to\_annual\_with\_promo.txt](https://github.com/Vindicia/CashBoxRESTCodeSamples/blob/master/Autobill/subscription_modify_monthly_to_annual_with_promo.txt)

   You must provide Subscribe with the following information to perform the upgrade using the API:

   * The item ID on the subscription that you wish to replace/upgrade. (An item represents a current product on the subscription.)
   * The old product ID for the item being upgraded.
   * The new product ID for the upgrade.
   * A new item ID for the item being created (this identifies the new product being added to the subscription).
   * (optional) The new billing plan ID. (Only required if you wish to change to a new billing plan.)
   * The date when the upgrade is effective. (options: `effective_date=today` or `effective_date= nextBill`)
     * This use case specifies today to have an immediate effect.
   * Whether the upgrade is prorated. (options: `billing_prorated_period=true` or `false`)
   * The campaign code to use for the promotion.
2. If the upgrade fails due to inability to collect funds, request a new payment method from the subscriber using PMT and resubmit the change with the new Payment Method VID.

* The Subscription contains the new product and the old one has been marked as removed.
* The new billing plan is in place (if applicable).
* Future billings are correctly predicted.
* The Account has been granted appropriate Entitlements.
* A transaction is generated if applicable, including any applicable taxation.
* A discount (% or flat rate) is applied at the time of purchase and is reflected in the Transaction and tax charges (if applicable).

**Parent topic:**[Enable Subscribers to Upgrade Subscriptions with Promotional Rate](../topics/2412_r_upgradeSubscriptionsPromo#)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.