Contract Properties

This reference describes finance and service contract properties including terms of the contract and attributes specific to finance and service contracts.

Finance Contract Properties lists the finance contract properties.
Table 1. Finance Contract Properties
Property Description
ID A unique, positive integer that identifies the contract type in the MATRIXX Engine.
Name (Required) A descriptive name for the contract, which displays in the Contract Table list of contracts from which to select. The name is also saved to the Event Detail Record (EDR) generated by MATRIXX Engine.
Description A description used to identify the contract.
External ID An optional field that you can use to identify this item in MATRIXX pricing items. External IDs are saved to the pricing configuration file and loaded into the pricing database. The value of an External ID can be set to any alphanumeric character that is meaningful to your implementation.
Start Date Activation date of the new revision of the contract.
Contract Period Specifies the contract term period:
  • empty (no value)
  • week
  • month
  • year
Contract Interval Required when Contract Period is set.

Specifies the number of contract periods in the contract. For example, if the interval is 12 and the Contract Period is month, then it is a 12-month contract.

Period Type Specifies the contract period type. Select from:
  • empty (no value)
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months
  • Years
Period Interval Required when Period Type is set. Specifies the number of intervals for the selected period type to define the length of the cycle period.
Late Charge Basis Specifies the late charge basis. Select from:
  • empty (no value)
  • Fixed
  • Percent of cycle recurring charges
Late Charge Required when Late Charge Basis is set. Specifies the late charge.
  • When set to Fixed, enter the late charge amount.
  • When set to Percent of installment, enter the percentage amount.
Late Charge Grace Period Type Specifies the late charge grace period type. Select from:
  • empty (no value)
  • immediate
  • minute
  • hour
  • day
  • week
  • month
Late Charge Grace Period Coefficient In Late Charge Grace Period Coefficient, enter the amount of time for the selected grace period type. For example, 2 days, 3 hours. This field is required when Late Charge Grace Period Type is set, unless Late Charge Grace Period Type is set to immediate or is empty, in which case Late Charge Grace Period Coefficient is disabled (not required).
Termination Charge Basis Specifies the termination charge basis. Select from:
  • empty (no value)
  • Fixed
  • Percent of outstanding principal
  • Fixed plus percent of outstanding principal
Termination Charge Fixed Fixed amount of termination charge. Enter the fixed amount if Termination Charge Basis is set to Fixed or Fixed plus percent of outstanding principal.
Termination Charge Percent Percent amount of termination charge. Enter the percentage if Termination Charge Basis is set to Percent of outstanding principal or Fixed plus percent of outstanding principal.
Termination on Early Payoff Specifies the contract status upon early pay-off. When selected, the finance contract status is set to terminated upon early principal pay-off. When deselected, the finance contract status is set to paid-off upon early principal pay-off.
Balance Class An optional balance class ID used to impact all payments.
Balance The currency balance template pricing ID used to create the contract debt balance instance based on the selected Balance Class. The balance is a simple, post-paid, currency balance with an unlimited credit limit.
Default or Minimum Down Payment Amount (Optional) Specifies the default or minimum down payment amount. This value can be overridden at the time of purchase through the purchase API.
Service Contract Properties lists the service contract properties.
Table 2. Service Contract Properties
Property Description
ID A unique, positive integer that identifies the contract type in the MATRIXX Engine.
Name (Required) A descriptive name for the contract, which displays in the Contract Table list of contracts from which to select. The name is also saved to the EDR generated by MATRIXX Engine.
Description A description used to identify the contract.
External ID An optional field that you can use to identify this item in MATRIXX pricing items. External IDs are saved to the pricing configuration file and loaded into the pricing database. The value of an External ID can be set to any alphanumeric character that is meaningful to your implementation.
Start Date Activation date of the new revision of the contract.
Is Open Contract Disabled if Contract Period is set.

Specifies whether the contract has an open term (no end date).

When selected, Contract Period and Contract Interval are disabled.
Contract Period Required if Is Open Contract is not selected.
Specifies the contract term period. Select from:
  • empty (no value)
  • week
  • month
  • year

Disabled if Is Open Contract is selected.

Contract Interval Required when Contract Period is set.

Specifies the number of contract periods in the contract. For example, if the interval is 12 and the Contract Period is month, then it is a 12-month contract.

Disabled if Is Open Contract is selected.

Period Type Specifies the contract period type. Select from:
  • empty (no value)
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months
  • Years
Period Interval Required when Period Type is set. Specifies the number of periods for the period type to define the length of the cycle period.
Commitment Period Specifies the type of commitment period. Select from:
  • empty (no value)
  • week
  • month
  • year
Commitment Period Interval Required when Commitment Period is set. Enter the Commitment Period Interval for the selected period.

Specifies the number of intervals for the specified commitment period.

Late Charge Basis Specifies the late charge basis. Select from:
  • empty (no value)
  • Fixed
  • Percent of cycle recurring charges
Late Charge Required when Late Charge Basis is set. Specifies the late charge.
  • When set to Fixed, enter the late charge amount.
  • When set to Percent of cycle recurring charges, enter the percentage amount.
Late Charge Grace Period Type Specifies the late charge grace period type. Select from:
  • empty (no value)
  • hour
  • day
  • week
  • month
  • immediate
Late Charge Grace Period Coefficient Required when Late Charge Grace Period Type is set. Specifies the time coefficient for the late charge grace period type.
Termination Charge Basis Specifies the termination charge basis. Select from:
  • empty (no value)
  • Fixed — When selected, enter the fixed amount in Termination Charge Fixed.
  • Percent of remaining cycle recurring charges — When selected, enter the percentage in Termination Charge Percent.
  • Fixed plus percent of remaining cycle recurring charges — When selected, enter the corresponding values in Termination Charge Fixed and Termination Charge Percent.
Disabled if an early termination charge (ETC) schedule is selected in ETC Schedule.
Termination Charge Fixed Fixed amount of termination charge. Enter the fixed amount if Termination Charge Basis is set to Fixed or Fixed plus percent of remaining cycle recurring charges.
Termination Charge Percent Percent amount of termination charge. Enter the percentage if Termination Charge Basis is set to Percent of remaining cycle recurring charges or Fixed plus percent of remaining cycle recurring charges.
Balance Class The balance class ID used to impact all payments.
Balance The currency balance template pricing ID used to create the contract debt balance instance based on the selected Balance Class. The balance is a simple, post-paid, currency balance with an unlimited credit limit.
ETC Schedule Service contract ETC schedule. Disabled if a termination charge basis is selected in Termination Charge Basis.
Note: The ETC schedule can be overridden at purchase time through the SubMan purchase and cancelation APIs.
Payment Schedule Service contract payment schedule.
Note: The payment schedule range, installment amounts, and final amount can be overridden at purchase time through the SubMan purchase and cancelation APIs.