Home > Aria6 User Documentation > Aria6 core api > get_supp_plans_by_promo_code
get_supp_plans_by_promo_code
get_supp_plans_by_promo_code
Table of contents
- Input Arguments
- Output Arguments
- Allowable values for supp_plan_ind
- Allowable values for billing_ind
- Allowable values for display_ind
- Allowable values for new_acct_status
- Allowable values for rollover_acct_status
- Allowable values for default_notify_method
- Allowable values for prepaid_ind
- Allowable values for proration_invoice_timing_cd
Returns a summary list of supplemental plans associated with a specified promotion code.
Input Arguments
| Req | Field Name | Field Type | Max Length | Description |
|---|---|---|---|---|
 |
client_no | long | 22 | Aria-assigned unique identifier indicating the Aria client providing service to this account. |
|
auth_key | string | 32 | Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor. |
|
promo_code | string | 255 | This is the code provided the client and used by the account holder during registration or when executing a transaction.A promotion generally provides access to a custom set of reduced-rate plans. |
| alt_caller_id | string | 30 | Person or process that submitted the API call. This can be someone's user ID, or the name of an application. | |
| optional_transaction_qualifiers | array | Array of additional values you can associate with this API call. | ||
 qualifier_name |
string | 100 | Name of the field you want to associate with this API call. | |
| qualifier_value |
string | 100 | Corresponding value of the field you want to associate with this API call. |
Output Arguments
| Field Name | Field Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| error_code | long | Aria-assigned error identifier. 0 indicates no error. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| error_msg | string | Description of any error that occurred. "OK" if there was no error. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| plans | hash | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| plan_no |
long | Aria-assigned unique plan identifier | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| plan_name |
string | Plan Name | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| plan_desc |
string | Text description of this plan | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| supp_plan_ind |
long | Indicates whether or not this plan is a supplemental plan.
Allowable values for supp_plan_ind
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| billing_interval |
long | Number of months between billing cycles | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| billing_ind |
long | Indicates whether or not this plan is billable
Allowable values for billing_ind
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| display_ind |
long | Indicates whether or not the plan is marked as "displayable". 0 means not displayable. 1 means displayable.
Allowable values for display_ind
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| rollover_months |
long | Number of months in which the account will change from the current plan to the pre-defined rollover plan. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| rollover_plan_no |
long | Pre-defined plan to which the account will change based on the defined rollover_months value; the rollover record is created when an account is placed on a plan with a defined rollover plan. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| early_cancel_fee |
double | Fee charged for early cancellations. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| early_cancel_min_months |
long | Number of months during which early cancellation fees would apply on plan cancellation. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| suspension_period |
long | Pre-defined period in days in which an account will degrade to Suspended status (-1) if action is not taken such as a plan or status change. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| new_acct_status |
long | The status code to assert for the new account.
Allowable values for new_acct_status
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| rollover_acct_status |
long | Default status for new accounts created on this plan.
Allowable values for rollover_acct_status
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| rollover_acct_status_days |
long | Number of days in which an account will change from the initial status code to the pre-defined rollover status code. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| init_free_months |
long | Initial free months. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| plan_2_assign_on_susp |
long | Plan to assign when an account on this plan is suspended. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| default_notify_method |
long | Default notification method given to an account that is assigned to this plan.
Allowable values for default_notify_method
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| prepaid_ind |
long | Indicates whether or not this plan is prepaid
Allowable values for prepaid_ind
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| currency_cd |
string | The 3-character ISO-compliant currency code in lowercase for monetary values used in the context of this API method. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| client_plan_id |
string | Client-defined Plan ID for which to query available child plans | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| client_rollover_plan_id |
string | Pre-defined plan to which the account will change based on the defined rollover_months value; the rollover record is created when an account is placed on a plan with a defined client rollover plan ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| client_plan_2_assign_on_susp |
string | Client-defined Plan identifier to assign when an account on this plan is suspended. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| proration_invoice_timing_cd |
string | Indicates whether to defer the pro-rated charges to the next anniversary date or to create a seperate invoice immediately.
Allowable values for proration_invoice_timing_cd
|
- © Copyright 2023 Aria Developer Central