TLV is a new format supported from Agnos Framework version 3.1.x
RAW is the Agnos Framework's legacy format
TLV Format
TLV TERMINAL is a TLV file starting by a header and followed by a set of TLV.
TLV TERMINAL | |||
|---|---|---|---|
Header (21 bytes) | |||
Version | unsigned char | Value between 0xAA and 0xAF | Current version: 0xAA |
SHA-1 | unsigned char[20] | SHA-1 calculation on the following data | n/a |
Body (variable) | |||
Tag | Length | Value | Example |
2 | Country Code (contact only) out of contact ICS CRC calculation | {0x01,0x24} | |
1 | Cardholder confirmation (contact only) | 0x00 or 0x01 | |
1 | Terminal type (contact only) | EMVCo book IV | |
1 | EMV contact supported (only if needed by Level3 and contact only) | 0x00 or 0x01 | |
3 | Terminal capabilities (contact only) | EMVCo book IV | |
5 | Additional terminal capabilities (contact only) | EMVCo book IV | |
1 | EMV contactless supported (contactless only) out of contact ICS CRC calculation | 0x00 or 0x01 | |
1 | Magstripe supported (only if needed by Level3 and contact only) | 0x00 or 0x01 | |
1 | Time allocated to enter a PIN out of contact ICS CRC calculation | Binary value: 0x0F for 15s | |
1 | Batch / Online Data Capture managed (only if needed by Level3 and contact only) | 0x00 or 0x01 | |
1 | Advice managedIndicates (only if needed by Level3 and contact only) | 0x00 or 0x01 | |
1 | PSE supported (contact only) | 0x00 or 0x01 | |
1 | AutoRun mode (contactless only) out of contact ICS CRC calculation | 0x00 or 0x01 | |
3 | Predefined amount for AutoRun mode (contactless only) out of contact ICS CRC calculation | Binary value | |
1 | PIN bypass supported (contact only) | 0x00 or 0x01 | |
1 | Referal managed (only if needed by Level3 and contact only) | 0x00 or 0x01 | |
1 | Default TAC supported when regular TACs are not present (contact only) | 0x00 or 0x01 | |
5 | Default TAC default (contact only) | Any value | |
5 | Default TAC denial (contact only) | Any value | |
5 | Default TAC online (contact only) | Any value | |
1 | Random Transaction Selection not supported (contact only) | 0x00 or 0x01 | |
1 | Velocity Checking not supported (contact only) | 0x00 or 0x01 | |
1 | CDA type (contact only) | 0x01, 0x02, or 0x03 | |
1 | Clipping mode supported. Be careful: this field is not supported by RAW format | 0x00 or 0x01 | |
1 | SRED mode supported. Be careful: this field is not supported by RAW format | 0x00 or 0x01 | |
RAW Format
RAW TERMINAL is a 44 byte long binary file followed by a 20 byte long SHA-1 calculation for integrity purposes.
RAW TERMINAL | ||
|---|---|---|
Body (44 bytes) | ||
Field | Format | Description |
TerminalCountryCode | unsigned char[2] | See TLV Format |
ProvideCardholderConfirmation | unsigned char | See TLV Format |
TerminalType | unsigned char | See TLV Format |
EMVContact | unsigned char | See TLV Format |
TerminalCapabilities | unsigned char[3] | See TLV Format |
AdditionalTerminalCapabilities | unsigned char[5] | See TLV Format |
EMVContactless | unsigned char | See TLV Format |
Magstripe | unsigned char | See TLV Format |
PINTimeOut | unsigned char | See TLV Format |
BatchManaged | unsigned char | See TLV Format |
AdviceManaged | unsigned char | See TLV Format |
PSE | unsigned char | See TLV Format |
AutoRun | unsigned char | See TLV Format |
PredefinedAmount | unsigned char[3] | See TLV Format |
PINByPass | unsigned char | See TLV Format |
ReferalManaged | unsigned char | See TLV Format |
DefaultTAC | unsigned char | See TLV Format |
DefaultTACDenial | unsigned char[5] | See TLV Format |
DefaultTACOnline | unsigned char[5] | See TLV Format |
DefaultTACDefault | unsigned char[5] | See TLV Format |
NotRTS | unsigned char | See TLV Format |
NotVelocity | unsigned char | See TLV Format |
CDAType | unsigned char | See TLV Format |
Trailer (20 bytes) | ||
Field | Format | Description |
SHA-1 | unsigned char[20] | Performed on previous 44 bytes |