F-125 Reserved Private - Associated Account Data
Description
This field contains account data (balances, awards and redemptions) related to account(s) associated with the transaction, if applicable.
Note that this field may contain one or more instances of the Associated Account subfield, each of which represents data for a single instance of an Associated Account. The value of each subfield is itself a TLV-encoded field, whose format is detailed below.
This is a TLV (Tag/Length/Value) encoded field, in LLLTLV format.
Subfield | Description | Tag | Format | Attribute | Conditions |
Associated Account | Data for a single instance of an account associated with the transaction. Note that there may be multiple instances of this subfield. | AAC | LLLTLV | Associated Account v ..999 (up to overall field capacity) | SM |
Associated Account
This subfield contains data related to a single instance of an account associated with the transaction.
This is a TLV (Tag/Length/Value) encoded field, in LLLTLV format.
Note that all subfields containing Unit measurements or balances are represented in the Unit Type associated with the Account Type for that Account. Each Unit measurement is expressed as “x+n 10.2”: the rightmost (least significant) two digits are fraction digits (to the right of the absent decimal point). The prefix must be “C” (credit) for positive or zero values, or “D” (debit) for negative values. For example, a credit balance of “12.34” would be expressed as “C1234”. The numerical portion of any such field is encoded in 4-bit Packed Unsigned BCD, as per the attribute definition; therefore any odd-length numerical values must be preceded by a leading zero nibble [0000] to ensure the numerical data is comprised of whole bytes only. Therefore, in the case of a credit of “1.23”, the value would be encoded as the ASCII byte “C” followed by the digits 0, 1, 2 and 3 (in 4-bit Packed Unsigned BCD). The overall length (in bytes) of this example value would be 3.
Attributes
V 999
Format
LLLTLV
Subfield | Description | Tag | Attribute | Conditions |
Account Type | Account Type to identify the type of account. Valid Account Types are defined below. | ACT | ans ..12 | SM |
Opening Unit Balance | Opening unit balance (before the effect of this transaction, if any) of the account associated with this transaction. | OUB | x+n 3..12 | SM |
Closing Unit Balance | Closing unit balance (after the effect of this transaction, if any) of the account associated with this transaction. | CUB | x+n 3..12 | SM |
Total Units Awarded | Total number of units awarded (credited, accrued) as a result of this transaction, if any, and added to the Closing Balance of the account associated with this transaction. This value includes any bonus units awarded. | TUA | x+n 3..12 | O |
Bonus Units Awarded | Number of units awarded (credited, accrued) as a bonus or other special condition as a result of this transaction, if any, and added to the Closing Balance of the account associated with this transaction. | BUA | x+n 3..12 | O |
Total Units Redeemed | Total number of units redeemed (debited, consumed) as a result of this transaction, if any, and deduced from the Opening Balance of the account associated with this transaction. | TUR | x+n 3..12 | O |
Account Type
Value | Description | Unit Type |
PMILES | Petron Miles loyalty scheme. | Petron Miles Point |
ADO | Malaysian ADO (Automated Diesel Oil) fuel subsidy/discount scheme. | Fuel, Litres |
FLEET | Petron Fleet Cards | Money, RM Amount |
On this page
- F-125 Reserved Private - Associated Account Data