Add a Supplemental Plan on an Anniversary Date

Overview

In this use case, you have a customer who wants to add a supplemental plan (product) on the next billing date (example: for financial convenience). You can add a supplemental plan this way by having it go into effect on its master plan's next anniversary date, as shown in the sample call below.

Example: you have a customer who is subscribed to a streaming plan (master plan) who now wants to add premium channels (supplemental plan).

Sample Call

1. Authenticate the customer logging into your user self-service (USS) application by calling the set_session_auth_m API.
2. Call the get_acct_details_all_m API to obtain the customer's plan information. 
3. Call the get_client_plans_basic_m API to obtain the plan(s) that the customer can add.
4. Call the assign_acct_plan_m API as follows:

1. Pass in your client number and authorization key:

   <lit:client_no>12345_sample_client_no</lit:client_no>
   <lit:auth_key>AbCdEfG_sample_auth_key</lit:auth_key>
   

2. Identify the customer who is adding a plan as shown below:

3. Identify the new plan to be assigned as shown below. In this example, we will add a supplemental plan.

4. Specify the master plan (parent plan) with which the supplemental plan should be associated as shown below.
   
   This will ensure that the supplemental plan will go into effect on your specified master plan's anniversary date. In addition, the supplemental plan will automatically be associated with that master plan's billing group and dunning group. Aria will bill the customer for the supplemental plan the same day on which that master plan is billed.
   
   Obtain the parent plan instance's identifier from the <master_plan_instance_no> field returned by the get_acct_details_all_m API.

5. Identify the quantity of the new product that the customer wants to purchase as shown below:

6. Specify the status that the new plan should be in as shown below:

7. Specify when the new plan assignment should happen and which proration rule should be applied as shown below.

Sample Response

You can check the customer's account in the Aria application to confirm that the plan addition was completed correctly as described in the use case above.