Create a Balance Threshold Grant

A balance threshold grant is applied to a balance at the time a balance or meter threshold is crossed. For more information about balance threshold based pricing, see the discussion about balance threshold-based pricing in Pricing and Rating.

Before you begin

Create the decision tables the rate tables will use.

About this task

Use positive numbers when defining discount amounts.

Procedure

  1. In Price Components, click the Grants tab, and click New Grant Component.
  2. In Create New Price Component:
    1. In Name, enter a unique name.
    2. (Optional) In Description, enter descriptive information about the item.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation of MATRIXX Engine. External IDs are saved to the pricing configuration file and loaded into the Pricing database.
    4. In Application, select balance_threshold.
    5. Skip the Service Type field (this field is only applicable to usage price components).
    6. Click Create.
  3. In Start Date/Time, use the date picker to select the date on which the object becomes active in the pricing database and is first available for use. Alternatively, enter the date in the format YYYY-MM-DD. Optionally, enter a time for when the object becomes active. The default is midnight. If applicable, the range in which the start date/time must fall is listed. For example:
    • Choose a date on or before 2021-12-01.
    • Choose a date on or after 2020-01-27.
    • Choose a date between 2000-01-02 and 2021-10-04.
    Note: If you are creating a new revision of this object, the start date must be greater than the start date of the previous revision and less than the start date of the next revision.
  4. In Target:
    • To apply the grant to a group balance, you can define a tier value or select a tier parameter; you cannot specify both. Select either:
      • Tier — In the Tier list, select the name of the tier containing the group to which the grant is to be applied. The event initiator must be a member of this group hierarchy. For information about creating tiers, see the discussion about adding a field to a pricing plan.
      • Tier Parameter — In the Tier Parameter list, select from all parameters set up in pricing.
    • To apply the grant to the balance of the event initiator, select Event Initiator.
  5. For Balance, click Select Balance and select the balance whose threshold, when crossed during rating, triggers the component to be applied for balance threshold based pricing.
  6. In Threshold, select the threshold (of the specified balance) that when crossed, triggers the component to be applied for balance threshold based pricing; if the threshold is updated, the balance must be reselected by clicking Select Balance to refresh the threshold.
    Note: Credit-limit thresholds and balance-floor thresholds are not available for selection on balance threshold pricing components.
  7. For Is Instance Specific:
    • Select this option if the balance threshold based pricing configuration for the component applies to only balance instances created by the containing offer.
    • De-select the option if the balance threshold based pricing configuration for the component applies to all balance instances in the balance template.
  8. Create a new rate table. For details, see the discussion about creating a new rate table.
  9. (Optional) To add a system attribute to the price component:
    1. In Edit Price Component for the price component, click the Attributes tab.
    2. Click Add Attribute.
    3. Select the system attribute from the list.
      Note: Add is disabled until you select an attribute.
    4. Click Add.
    5. In the Attributes tab, click Save.

      Repeat these steps for each system attribute to add to the rate table.

      To change the value of an attribute, click the cell in the Value column for the attribute, and select the value from the list (if the attribute has allowed values) or enter the value.

      To delete a system attribute, click Delete the selected object in the Delete column for the attribute.

  10. (Optional) Add parameters to the list of price component parameters on the Parameters tab.
    Note: You can use price component parameters in rating formulas. When you add a parameter to a rating formula, it is also added to the parent price component.

    When you assign a price component that has parameters to an offer or a bundle, MATRIXX also creates a default parameter binding between each price component parameter and a parameter with the same name in the offer or bundle. Any parameters that are not already assigned to the offer or bundle, are added to the list of offer or bundle parameters without you having to add them manually.

    For more information about adding parameters to a price component, see the discussion about adding a parameter to a price component.