Balance Template Start/End Properties

Start and end properties listed in Start/End Properties define the balance start and end dates, how balances can be adjusted, and the default end date extension value.

Table 1. Start/End Properties
Property Description
Start Date Specifies the start date of the balance as one of:
  • None — The balance is available immediately.
  • Absolute — The balance is available on the specified date. If you do not specify a time, the balance starts at 00:00:00 AM on the specified date.
  • Relative — The balance is available on the Purchase Date or the Provisioning Date.
    Note: These values have the balance start on the same date, so it does not matter which value you select.
End Date Specifies the balance end date as one of:
  • None — The balance is available indefinitely.
  • Absolute — The balance becomes unavailable for usage on the specified date.
  • Relative — The balance becomes unavailable for usage after the specified time period, relative to the balance start time or purchase time. The time period can be any number of minutes, days, weeks, months or years after the start time or purchase time. If you do not specify a time, the balance expires at 12:59:59 PM on the specified date.
  • Purchased Item Aligned — The end time is set to the end time of the catalog item that creates the balance.
Note: When defining a periodic balance or on-demand periodic balance, you cannot set the end time to the past.
End Date Adjustment Type A balance amount can be made available for a longer period of time by extending the balance validity end date during a manual balance top-up or adjustment operation. The balance can be configured with one of the following end time adjustment settings:
  • Allow — A new validity end date can be specified during a top-up operation. If you select this option, you can optionally specify a Default Extension time, so the extended period does not have to be specified during the top-up operation. If you do not specify a Default Extension, one must be specified during the top-up operation.
  • Always Use Default — The validity end date is always extended to the amount of time specified as the Default Extension.
  • Deny — The validity end date cannot be extended.
To specify the Default Extension, enter an integer for the number of units by which to extend the end date and select the unit type:
  • minutes
  • hours
  • days
  • weeks
  • months
  • years
For example, to extend the end date 2 weeks, enter 2 and select weeks.
Note: The validity end time of a balance instance can also be extended when a subscriber or group purchases a product offer. This end date extension is implemented by including a balance state update component in the product offer and configuring the balance state update component to select a balance state update profile. The profile specifies how to extend the balance end time.
Default Extension The default end date extension. Enter an integer for the number of units by which to extend the end date, and select the unit type:
  • minutes
  • hours
  • days
  • weeks
  • months
  • years
For example, to extend the end date 2 weeks, enter 2 and select weeks.
Note: The validity end time of a balance instance can also be extended when a subscriber or group purchases a product offer. This end date extension is implemented by including a balance state update component in the product offer and configuring the balance state update component to select a balance state update profile. The profile specifies how to extend the balance end time.
Leave the field blank and select empty as the unit type if there is no default extension.