EMV Types

The device formats ARQC messages as shown in Table 19. The default is an EMV standard list of ARQC message tags. The host may also customize the contents of ARQC messages by setting Property 1.1.1.1.1.2 EMV ARQC Message Tag List.

EMV ARQC (DynaPro Format) Type

Table - EMV ARQC (DynaPro Format) Type

Tag

Len

Value / Description

Typ

Req

Default

2-byte MSB message length excluding padding and CBC-MAC

var

Container for MAC structure and generic data

/DFDF54

var

MAC KSN

/DFDF55

MAC Encryption Type

See section 4.4 Encryption Type for a list of valid values.

/DFDF25

var

Device Serial Number (IFD Serial Number)

/FA

var

Container for generic data

//70

var

Container for ARQC

///82

Application Interchange Profile

Available on:

DynaFlex I FW Ver CA1 or newer DynaProx FW Ver A8 or newer DynaFlex II FW Ver A6 or newer

///9F6E

var

Third Party Data

Available on:

DynaFlex I FW Ver CA1 or newer DynaProx FW Ver A8 or newer DynaFlex II FW Ver A6 or newer

///DFDF53

Fallback Indicator

· 0x00 = No Fallback

· 0x01 = Technical Fallback

· 0x81 = MSR Fallback

///DFDF33

var

Masked Track 2 MSR Data

If the payment method presented by the cardholder provides it

///DFDF4D

var

Masked Track 2 ICC Data

If the payment method presented by the cardholder provides it

///DFDF52

Card Type

· 0x00 = Other

· 0x01 = Magnetic Stripe ISO/ABA Financial (MSR)

· 0x02 = Magnetic Stripe AAMVA (MSR)

· 0x03 = Manual Entry

· 0x04 = Unknown

· 0x05 = Contact Chip Card (ICC)

· 0x06 = Contactless Chip Card (PICC), EMV

· 0x07 = MSR Financial and Contact Chip Card (ICC)

Table - EMV ARQC (DynaPro Format) Type

Tag

Len

Value / Description

Typ

Req

Default

· 0x08 = Contactless PICC, Magnetic Stripe Data (MSD)

///FF42

var

Container for Selectable Encrypted Card Data Set up OID 1.1.2.6.1.1 to enable this container.

////DFDFDF37

var

Selectable Encrypted Data Primitive

Decrypt the value of this TLV data object using the algorithm and variant specified in the Selectable Encrypted Data KSN parameter and the Selectable Encrypted Data Encryption Type parameter. See Table 21 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents for the data structure as it should appear after decryption.

(This item will be present if 0xFF42 is enabled)

////DFDFDF38

Selectable Encrypted Data KSN

(This item will be present if 0xFF42 is enabled)

////DFDFDF39

Selectable Encrypted Data Encryption Type (This item will be present if 0xFF42 is enabled)

///DF2A

Tip Mode Sale Amount Entered

///DF2B

Tip Mode Total Amount

///DF5D

Tip Amount

///DF5E

Tax Amount

///F8

var

Container for Encrypted Data

////DFDF59

var

Encrypted Data Primitive

Decrypt the value of this TLV data object using the algorithm and variant specified in the Encrypted Transaction Data KSN parameter and the Encrypted Transaction Data Encryption Type parameter to read its contents. See Table 20 for the data structure as it should appear after decryption.

////DFDF56

var

Encrypted Transaction Data KSN

////DFDF57

Encrypted Transaction Data Encryption Type

See section 4.4 Encryption Type for a list of valid values.

////DFDF58

Number of Padding Bytes

Number of bytes added to DFDF59 value to force its length to a multiple of 8 bytes for TDES, or 16 bytes for AES.

/FE

Var

VAS Data Container

See Table 25 – VAS Data Container Payload

/FF40

Var

Fleet Data Container (Common Kernel Only)

See Table 4.5 9 – Fleet Data Container Payload

Table - EMV ARQC (DynaPro Format) Type

Tag

Len

Value / Description

Typ

Req

Default

Padding to ensure the length of data, starting with the message length at the very beginning, and ending with any additional padding, is a multiple of 8 bytes for TDES, or 16 bytes for AES. This is a requirement of using the CBC-MAC algorithm.

Four-byte CBC-MAC. The host should calculate the CBC-MAC and verify that it matches. For details about calculating a CBC-MAC, see About Message Authentication Codes (MAC).

The device encrypts the value inside the Encrypted Data Primitive container using the Encrypted Transaction Data Encryption Type parameter and working key associated with the keyset number currently active in the device’s configuration. As a requirement for using DUKPT encryption algorithms, the device pads it so the length of its value is a multiple of 8 bytes for TDES, or 16 bytes for AES. The device uses container DFDF58 to report how many bytes of data object DFDF59 are padding. Data object DFDF59 itself is formatted like Table 20 after the host decrypts it.

Table - EMV ARQC (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

Inside this container, the device inserts all EMV TLV data objects specified by the setting in Property 1.1.1.1.1.2 EMV ARQC Message Tag List. The remainder of this table shows the basic structure and content of MagTek custom tags. For definitions of all other standard EMV tags that can be included directly under container FC, see EMV 4.3 Book 3.

/DF29

Only if tag DF29 is included in Property 1.1.1.1.1.2 EMV ARQC Message Tag List.

Outcome Parameter Set Byte 1 - Outcome

0x10 = Approved

0x20 = Declined

0x30 = Online Request 0x40 = End Application

0x50 = Select Next Application 0x60 = Try Another Interface 0x70 = Try Again

0xF0 = N/A

Byte 2 – Entry Point Start 0x00 = Start A

0x10 = Start B 0x20 = Start C 0x30 = Start D 0xF0 = N/A

Byte 3 – Entry Point Online Response

Table - EMV ARQC (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

0x00 = EMV Data 0x10 = Any

0xF0 = N/A

Byte 4 – CVM 0x00 = No CVM

0x10 = Obtain Signature 0x20 = Online PIN

0x30 = Confirmation Code Verified 0xF0 = N/A

Byte 5 – UI/Data/Receipt

0x80 = UI Request on Outcome Present 0x40 = UI Request on Restart Present 0x20 = Data Record Present

0x10 = Discretionary Data Present 0x08 = Provide Receipt

Byte 6 – Alternate Interface Preference 0x10 = Contact

0x20 = MSR

0xF0 = N/A

Byte 7 – Field Off Request FF = N/A

Byte 8 – Removal Timeout

/F4

var

Container for encrypted MSR data (MSR Only)

//DFDF36

Encrypted Track 1 Status (MSR Only)

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

//DFDF37

var

Encrypted Track 1 Data (MSR Only)

//DFDF38

Encrypted Track 2 Status (MSR Only)

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

//DFDF39

var

Encrypted Track 2 Data (MSR Only)

//DFDF3A

Encrypted Track 3 Status (MSR Only)

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

Table - EMV ARQC (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

//DFDF3B

var

Encrypted Track 3 Data (MSR Only)

//DFDF3C

var

Encrypted MagnePrint Data (MSR Only)

Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.

//DFDF43

MagnePrint Status Data (MSR Only)

Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.

· Bit 0 = MagnePrint Capable Flag

o 0 = Device is not MagnePrint capable

o 1 = Device is MagnePrint capable

· Bits 1 through 3 = Mode

o 0 = Standard MagnePrint

o 1 = Extended MagnePrint

· Bits 4 through 15 = ASIC Revision

· Bit 16 = Reserved

· Bit 17 = Reserved

· Bit 18 = Swipe too slow

· Bit 19 = Swipe too fast

· Bit 20 = Reserved

· Bit 21 = Card swipe direction

o 0 = Forward

o 1 = Reverse Bits 22..31 = Reserved

//DFDF50

var

MSR KSN Data (MSR Only)

Key Serial Number for the key the host should use to decrypt Encrypted Track 1 Data, Encrypted Track 2 Data, Encrypted Track 3 Data and Encrypted MagnePrint Data.

//DFDF51

MSR Encryption Type (MSR Only)

See section 4.4 Encryption Type for a list of valid values.

/FF73

var

Container for Encrypted MagnePrint Data (MSR Only) Only included when Track Data and MagnePrint encryption keys are using different KSN

//DFDF3C

var

Encrypted MagnePrint Data (MSR Only) Only included for MSR swipe transactions.

//DFDF43

MagnePrint Status Data (MSR Only)

Only included for MSR swipe transactions.

· Bit 0 = MagnePrint Capable Flag

o 0 = Device is not MagnePrint capable

o 1 = Device is MagnePrint capable

· Bits 1 through 3 = Mode

o 0 = Standard MagnePrint

o 1 = Extended MagnePrint

· Bits 4 through 15 = ASIC Revision

Table - EMV ARQC (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

· Bit 16 = Reserved

· Bit 17 = Reserved

· Bit 18 = Swipe too slow

· Bit 19 = Swipe too fast

· Bit 20 = Reserved

· Bit 21 = Card swipe direction

o 0 = Forward

o 1 = Reverse Bits 22..31 = Reserved

//DFDF50

var

MSR KSN Data (MSR Only)

Key Serial Number for the key the host should use to decrypt Encrypted MagnePrint Data.

//DFDF51

MSR Encryption Type (MSR Only)

See section 4.4 Encryption Type for a list of valid values.

/F5

var

Container for Encrypted PIN Data (Touch Only) Contains ISO PIN Block formatted data in the nested Encrypted PIN Data object, plus supporting information

to decrypt it. The host should use the current PIN DUKPT working key specified in the supporting information.

//DF71

PIN Block Format (Touch Only)

· 0x00 = ISO Format 0

· 0x01 = ISO Format 1

· 0x03 = ISO Format 3

· 0x04 = ISO Format 4

//99

Encrypted PIN Data (Touch Only)

//DFDF41

var

PIN KSN Data (Touch Only)

//DFDF42

PIN Encryption Type (Touch Only)

See section 4.4 Encryption Type for a list of valid values.

Padding to force DFDF59 plus padding to be a multiple of 8 bytes

Table - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

Inside this container, if the data is not available for a given selected card data, the tag will still get transmitted with a length of ‘1’ and value = ‘*’.

/5F20

var

Only if Byte 0 – Bit 0 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

Cardholder Name

/5A

var

Only if Byte 0 – Bit 1 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

n15/ n16

Table - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

Primary Account Number

/5F24

02/

Only if Byte 0 – Bit 2 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

Expiration Date, YYMM or YYMMDD

n4/ n6

/5F30

Only if Byte 0 – Bit 3 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

Service Code

/9F1F

var

Only if Byte 0 – Bit 4 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

T1 Discretionary Data

/9F20

var

Only if Byte 0 – Bit 5 is set in Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable.

T2 Discretionary Data

Padding to force DFDFDF37 plus padding to be a multiple of 16 bytes for AES encryption.

Table – EMV ARQC Enhanced DFDF59 Decrypted Contents for EMV Data

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

This contains all EMV TLV data objects specified in

Property 1.1.1.1.1.2 EMV ARQC Message Tag List.

/FE

Var

VAS Data Container

See Table 25 – VAS Data Container Payload

Table – EMV ARQC Enhanced DFDF59 Decrypted Contents for MSR and MagnePrint Data

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

/9F41

Transaction Counter

Table – EMV ARQC Enhanced DFDF59 Decrypted Contents for MSR and MagnePrint Data

Tag

Len

Value / Description

Typ

Req

Default

Starts at 00000000 each time the device powers up or resets, increments for each transaction.

/DFDF36

MSR Track 1 Status

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

/DF41

var

MSR Track 1 Clear Text

/DFDF38

MSR Track 2 Status

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

/DF42

var

MSR Track 2 Clear Text

/DFDF3A

MSR Track 3 Status

· 0x00 = OK

· 0x01 = Empty

· 0x02 = Error

· 0x03 = Disabled

/DF43

var

MSR Track 3 Clear Text

/DFDF43

MagnePrint Status

The device only includes this if MSR and MagnePrint data are both included in the transaction and the device is configured to encrypt them using the same key, to avoid consuming two DUKPT keys encrypting separate containers. If the device is configured to encrypt MSR and MagnePrint data using different keys, it provides MagnePrint data in the Container for Encrypted MagnePrint Data instead.

· Bit 0 = MagnePrint Capable Flag

o 0 = Device is not MagnePrint capable

o 1 = Device is MagnePrint capable

· Bits 1 through 3 = Mode

o 0 = Standard MagnePrint

o 1 = Extended MagnePrint

· Bits 4 through 15 = ASIC Revision

· Bit 16 = Reserved

· Bit 17 = Reserved

· Bit 18 = Swipe too slow

· Bit 19 = Swipe too fast

· Bit 20 = Reserved

· Bit 21 = Card swipe direction

0 = Forward
1 = Reverse
Bits 22..31 = Reserved

Table – EMV ARQC Enhanced DFDF59 Decrypted Contents for MSR and MagnePrint Data

Tag

Len

Value / Description

Typ

Req

Default

/DF44

var

MagnePrint Data

The device only includes this if MSR and MagnePrint data are both included in the transaction and the device is configured to encrypt them using the same key. The host can use this data in conjunction with Magensa services to determine whether the swiped card is authentic.

/FE

Var

VAS Data Container

See Table 25 – VAS Data Container Payload

Table – EMV ARQC Enhanced DFDF59 Decrypted Contents for MagnePrint Data

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

/DFDF43

var

MagnePrint Status

The device only includes this when MSR and MagnePrint data are included in the transaction, but the device is configured to encrypt them using a different key.

· Bit 0 = MagnePrint Capable Flag

o 0 = Device is not MagnePrint capable

o 1 = Device is MagnePrint capable

· Bits 1..15 = Product revision & mode

· Bit 16 = Reserved

· Bit 17 = Reserved for noise measurement

· Bit 18 = Swipe too slow

· Bit 19 = Swipe too fast

· Bit 20 = Reserved

· Bit 21 = Card swipe direction

o 0 = Forward

o 1 = Reverse

· Bits 22..31 = Reserved

/DF44

var

MagnePrint Data

The host can use this data in conjunction with Magensa services to determine whether the swiped card is authentic.

/DF4B

var

MSR PAN

/FE

Var

VAS Data Container

See Table 25 – VAS Data Container Payload

Table - VAS Data Container Payload

Tag

Len

Value / Description

Typ

Req

Default

/FE

var

VAS Data Container

//FF01

var

Apple VAS Container Slot 1 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF02

var

Apple VAS Container Slot 2 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF03

var

Apple VAS Container Slot 3 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF04

var

Apple VAS Container Slot 4 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF05

var

Apple VAS Container Slot 5 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF06

var

Apple VAS Container Slot 6 Container

///9F27

var

VAS Data

Up to 128 bytes.

///9F2A

var

Mobile Token Up to 36 bytes.

//FF41

var

Google Smart Tap Container

///FF01

var

Collector ID Slot 1 Container

////DF7B

var

Service Response NDEF Record

///FF02

var

Collector ID Slot 2 Container

////DF7B

var

Service Response NDEF Record

Table – VAS Data Container Payload

Tag

Len

Value / Description

Typ

Req

Default

///FF03

var

Collector ID Slot 3 Container

////DF7B

var

Service Response NDEF Record

///FF04

var

Collector ID Slot 4 Container

////DF7B

var

Service Response NDEF Record

///FF05

var

Collector ID Slot 5 Container

////DF7B

var

Service Response NDEF Record

///FF06

var

Collector ID Slot 6 Container

////DF7B

var

Service Response NDEF Record

Table – Fleet Data Container Payload (Common Kernel Only)

Tag

Len

Value / Description

Typ

Req

Default

/FF40

var

Fleet Data Container

//DF30

var

Prompting

//DF32

var

Purchase Restrictions

//DF33

var

//DF34

var

Chip Offline purchase Restrictions for Fuel

//DF35

var

Chip Offline purchase Restrictions for Non-fuel

//DF36

var

Relationship Codes

//DF37

var

3^rd Party Reference Data Generation 2

//DF38

var

Loyalty ID

//DF39

var

Purchase Device Sequence Number

//DF40

var

Generic Tag

//DF41

var

Vehicle/Trailer Number

//DF42

var

Vehicle Tag

//DF43

var

Driver ID

//DF44

var

Driver’s License Number

//DF45

var

Driver’s License State/Province Abbreviation

//DF46

var

Driver’s License Name Abbreviation

//DF47

var

Date of Birth

//DF48

var

Zip/Postal Code

//DF49 –

//DF51

var

IFSR Reserved for Future Use

//DF52

var

Trailer Number

Table – Fleet Data Container Payload (Common Kernel Only)

Tag

Len

Value / Description

Typ

Req

Default

//DF53

var

Employee Number

//DF54

var

Work Order / Purchase Order Number

//DF55

var

Additional Prompted Data 1

//DF56

var

Additional Prompted Data 2

//DF57

var

Proprietary Data

//9F5A

var

//9F0A

var

ASRPD

//9F6E

var

M/C Fleet

//9FD4

var

//9F50

var

Table – EMV ARPC Data

Tag

Len

Value / Description

Typ

Req

Default

FF74

var

Container for non-MAC ARPC

/DFDF25

var

Device Serial Number (IFD Serial Number)

/FA

var

Container for generic data

//70

var

Container for ARPC

///8A

Authorization Response Code

‘00’ = Approved
‘01’ = Issuer Referral
‘05’ = Declined
‘12’ = Switch Interface
‘13’ = Request Online PIN

///91

var

Issuer Authentication Data As defined in EMV Integrated Circuit Card Specifications for Payment Systems 4.3

///71

var

Issuer Script Template 1 As defined in EMV Integrated Circuit Card Specifications for Payment Systems 4.3. The host may include as many instances of this parameter as needed, up to a maximum length of 128 bytes including Tags and Lengths.

///72

var

Issuer Script Template 2 As defined in EMV Integrated Circuit Card Specifications for Payment Systems 4.3. The host may include as many instances of this parameter as needed, up to a maximum length of 128 bytes including Tags and Lengths.

EMV Batch Data Type

The device formats EMV batch data, such as merchant data and pre-defined EMV batch data tags, using the format shown in Table 27. The default is an EMV standard list of batch data message tags. The host may also customize the contents of batch data messages by setting Property 1.1.1.1.1.3 EMV Batch Data Tag List.

(EMV Contact Only) For unsuccessful transactions, this data object can contain additional pre-defined reversal data. It is normally used by the host for data capture. The default is an EMV standard list of reversal data message tags. The host may also customize the contents of reversal data messages by setting Property 1.1.1.1.1.4 EMV Reversal Data Tag List.

As part of successful completion of Command 0x1001 - Start Transaction, this data structure contains the results of the transaction. The set of tags used during a given EMV transaction is a combination of the tags defined in the EMV specification and the tags that are specific to the kernel being used for the transaction.

EMV Batch Data (DynaPro Format) Type

Table – EMV Batch Data (DynaPro Format) Type

Tag

Len

Value / Description

Typ

Req

Default

2-byte MSB message length excluding padding and CBC-MAC

var

Container for MAC structure and generic data

/DFDF54

var

MAC KSN

/DFDF55

MAC Encryption Type See section 4.4 Encryption Type for a list of valid values.

/DFDF25

var

Device Serial Number (IFD Serial Number)

/FA

var

Container for Generic Data

//F0

var

Transaction Results

///F1

var

Container for Status Data

////DFDF1A

Transaction Status

0x00 = Accept
0x01 = Decline
0x02 = Error

////DFDF1B

Additional Transaction Information 0x00

///F8

var

Container for Encrypted Data

////DFDF59

var

Encrypted Data Primitive Decrypt the value of this TLV data object according to the Encrypted Transaction Data KSN parameter and the Encrypted Transaction Data Encryption Type parameter to read its contents. See Table 28 for the data structure as it should appear after decryption. Use the data variant of the current MSR DUKPT working key used in the relevant transaction.

////DFDF56

var

Encrypted Transaction Data KSN

////DFDF57

Encrypted Transaction Data Encryption Type See section 4.4 Encryption Type for a list of valid values.

////DFDF58

Number of padding bytes added to DFDF59 value to force length to a multiple of 8 bytes

///F7

var

Merchant Data This contains an instance of Merchant Data Container.

/FE

Var

VAS Data Container See Table 25 – VAS Data Container Payload

Four-byte CBC-MAC. The host should calculate the CBC-MAC and verify that it matches. For details about calculating a CBC-MAC, see About Message Authentication Codes (MAC).

Table – EMV Batch Data (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

/F2

var

Container for Batch Data This data object contains the set of EMV TLV data objects specified in Property 1.1.1.1.1.3 EMV Batch Data Tag List.

//DF29

Only if tag DF29 is included in Property 1.1.1.1.1.3 EMV Batch Data Tag List Outcome Parameter Set Byte 1 - Outcome 0x10 = Approved 0x20 = Declined 0x30 = Online Request 0x40 = End Application 0x50 = Select Next Application 0x60 = Try Another Interface 0x70 = Try Again 0xF0 = N/A Byte 2 – Entry Point Start 0x00 = Start A 0x10 = Start B 0x20 = Start C 0x30 = Start D 0xF0 = N/A Byte 3 – Entry Point Online Response 0x00 = EMV Data 0x10 = Any 0xF0 = N/A Byte 4 – CVM 0x00 = No CVM 0x10 = Obtain Signature 0x20 = Online PIN 0x30 = Confirmation Code Verified 0xF0 = N/A Byte 5 – UI/Data/Receipt 0x80 = UI Request on Outcome Present 0x40 = UI Request on Restart Present 0x20 = Data Record Present 0x10 = Discretionary Data Present 0x08 = Provide Receipt Byte 6 – Alternate Interface Preference 0x10 = Contact 0x20 = MSR 0xF0 = N/A Byte 7 – Field Off Request FF = N/A Byte 8 – Removal Timeout

/F3

var

(EMV Contact Only) Container for Reversal Data, if any This data object contains the set of EMV TLV data objects specified in Property 1.1.1.1.1.4 EMV Reversal Data Tag List.

null

/F4

var

Container for encrypted MSR data (MSR Only)

//DFDF36

Encrypted Track 1 Status (MSR Only)

0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled [Property 1.1.2.5.1.2 Track 1 Enable (MSR Only) set to Disabled]

//DFDF37

var

Encrypted Track 1 Data (MSR Only)

//DFDF38

Encrypted Track 2 Status (MSR Only)

0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled [Property 1.1.2.5.1.3 Track 2 Enable (MSR Only) set to Disabled]

//DFDF39

var

Encrypted Track 2 Data (MSR Only)

//DFDF3A

Encrypted Track 3 Status (MSR Only)

0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled [Property 1.1.2.5.1.4 Track 3 Enable (MSR Only) set to Disabled]

//DFDF3B

var

Encrypted Track 3 Data (MSR Only)

//DFDF3C

var

Encrypted MagnePrint Data (MSR Only) Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.

//DFDF43

MagnePrint Status Data (MSR Only) Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.

//DFDF50

var

MSR KSN Data (MSR Only)

//DFDF51

MSR Encryption Type (MSR Only) See section 4.4 Encryption Type for a list of valid values.

/FF73

var

Container for Encrypted MagnePrint Data (MSR Only) Only included when Track Data and MagnePrint encryption keys are using different KSN

//DFDF3C

var

Encrypted MagnePrint Data (MSR Only) Only included for MSR swipe transactions.

//DFDF43

MagnePrint Status Data (MSR Only) Only included for MSR swipe transactions.

//DFDF50

var

MSR KSN Data (MSR Only) Key Serial Number for the key the host should use to decrypt Encrypted MagnePrint Data.

//DFDF51

MSR Encryption Type (MSR Only) See section 4.4 Encryption Type for a list of valid values.

/F5

Container for Encrypted PIN Data (Touch Only)

//DF71

PIN Block Format (Touch Only)

0x00 = ISO Format 0
0x01 = ISO Format 1
0x03 = ISO Format 3
0x04 = ISO Format 4

//99

Encrypted PIN Data (Touch Only)

//DFDF41

PIN KSN Data (Touch Only)

//DFDF42

PIN Encryption Type (Touch Only) See section 4.4 Encryption Type for a list of valid values.

null

(var)

Padding to force DFDF59 plus padding to be a multiple of 8 bytes

Table - EMV Batch Data (DynaPro Format) DFDF59 Decrypted Contents

Tag

Len

Value / Description

Typ

Req

Default

var

Decrypted Data Container

/F2

var

Container for Batch Data This data object contains the set of EMV TLV data objects specified in Property 1.1.1.1.1.3 EMV Batch Data Tag List.

/F3

var

Container for Reversal Data, if any This data object contains the set of EMV TLV data objects specified in Property 1.1.1.1.1.4 EMV Reversal Data Tag List.

null

(var)

Padding to force DFDF59 plus padding to be a multiple of 8 bytes or 16 bytes depending on the cipher block size of the algorithm being used.

/FE

Var

VAS Data Container See Table 25 – VAS Data Container Payload

/FE

Merchant Data Container

Merchant Data is normally used by the host for receipt printing. The contents of this container are not customizable.

Table - Merchant Data Container

EMV Terminal Configuration File Type

The host uses Command 0xD812 - Start Send File to Device (Unsecured) to load this file type to control the behavior of the device’s EMV contact kernel. The configuration loaded using this file type must be designed to work together with all instances of EMV Processing Configuration File Type and EMV Entry Point Configuration File Type the host loads into the device.

MagTek provides tools that allow these settings to be loaded using a Microsoft Excel spreadsheet for more convenient authoring, review, and change tracking. For a reference sample spreadsheet that contains EMVCo approved configurations, contact MagTek Support Services.

This document shows one example of the available Contact Level 2 certified configurations (DynaFlex C01, Merchant, Attended, ODA). To see which configurations are supported on the devices you are using, see the list of Vendor Config IDs in the device’s Letter of Approval for Contact Level 2 posted in the list of Approved / Evaluated products on the EMVCo web site. For detailed descriptions of the tags included in this file type, including possible valid values and their effects on device behavior, see EMV Integrated Circuit Card Specifications for Payment Systems v4.3.

Table - EMV Configuration Terminal File Type

Tag

Len

Value / Description

Typ

Req

Example

File Type Version

One byte indicating the version of the file type format being used.

0xAA

SHA-1 Hash

20-byte hash of all values that follow.

9F1A

Terminal Country Code

08 40

DF79

Cardholder Confirmation

9F35

Terminal Type

DF0A

EMV Contact Supported

9F33

Terminal Capabilities

E0 28 C8

9F40

Additional Terminal Capabilities

EF 80 F0 A0 01

DF55

EMV Contactless Supported

DF0B

Magnetic Stripe Supported

DF27

Time allocated to enter a PIN

DF06

Batch / Online Data Capture managed

DF08

Advice Managed

DF7A

PSE Supported

DF0D

AutoRun Mode

DF10

Predefined amount for AutoRun mode

00 00 00

DF7B

PIN Bypass Supported

DF07

Referral Managed

DF09

Default TAC supported when regular TACs are not present

DF73

Default TAC default

00 00 00 00 00

DF74

Default TAC denial

00 00 00 00 00

DF75

Default TAC online

00 00 00 00 00

DF53

Random Transaction Selection not supported

DF54

Velocity Checking not supported

DF7C

CDA Mode

EMV Processing Configuration File Type

The host uses Command 0xD812 - Start Send File to Device (Unsecured) to load this file type to control the behavior of the device’s EMV kernels. The host must compile a single instance of this file type containing multiple instances of the AID Delimiter Container, one for each contact or contactless AID the device should support. For each instance of the AID Delimiter Container where tag 9F01 is set to a contactless AID, the host must load a corresponding instance of an Entry Point Table when it loads the EMV Entry Point Configuration File Type.

Table - EMV Configuration Processing File Type

File Type Version

One byte indicating the version of the file type format being used. 0xAA

SHA-1 Hash

20-byte hash of all values that follow.

FF33

var

Inside each AID Delimiter Container:

Tag

Len

Value / Description

Typ

Req

Example

/9F01

Payment Brand Identifier This serves as supporting information to clarify whether this instance of the AID Delimiter Container is for Contact or Contactless. Byte 1 upper nibble must be set to a value flagging that it corresponds to a Contactless AID, generally by using 0xC0 or 0xF0. For Contact AID, the value of Byte 1 is 00. Byte 1 lower nibble:

0 = Contact
1 = Interac (Common Kernel Only)
2 = Mastercard Contactless
3 = Visa payWave
4 = Expresspay
5 = JCB (Common Kernel Only)
6 = Discover D-PAS
7 = China UnionPay (Common Kernel Only)

Bytes 2..5 Reserved for future use

F2 00 00 00 00 00

/4F

0..16

Application Identifier (AID)

A0 00 00 00 04 10 10

/DF7E

ASI

/9F09

Application Version Only applies when Payment Brand Identifier indicates Contact.

00 00

/DF11

Skip TAC/IAC default supported Only applies when Payment Brand Identifier indicates Contact.

/DF12

Random transaction selection supported Only applies when Payment Brand Identifier indicates Contact.

/DF13

Velocity checking supported Only applies when Payment Brand Identifier indicates Contact.

/DF14

Floor limit checking supported Only applies when Payment Brand Identifier indicates Contact.

/DF15

TAC supported Only applies when Payment Brand Identifier indicates Contact.

/DF20

TAC default Only applies when Payment Brand Identifier indicates Contact.

00 00 00 00 00

/DF21

TAC denial Only applies when Payment Brand Identifier indicates Contact.

00 00 00 00 00

/DF22

TAC online Only applies when Payment Brand Identifier indicates Contact.

00 00 00 00 00

/9F1B

Floor limit Only applies when Payment Brand Identifier indicates Contact.

00 00 00 00

/DF70

Target percentage Only applies when Payment Brand Identifier indicates Contact.

/DF6E

Threshold value Only applies when Payment Brand Identifier indicates Contact.

00 00 00

/DF6F

Maximum target percentage Only applies when Payment Brand Identifier indicates Contact.

/DF01

Default DDOL supported Only applies when Payment Brand Identifier indicates Contact.

/DF71

0..FC

DDOL Only applies when Payment Brand Identifier indicates Contact.

/DF02

Default TDOL supported Only applies when Payment Brand Identifier indicates Contact.

/DF72

0..252

TDOL Only applies when Payment Brand Identifier indicates Contact.

/5F2A

Currency Code Only applies when Payment Brand Identifier indicates Contact.

00 00

/5F36

Transaction currency exponent Only applies when Payment Brand Identifier indicates Contact.

Additional instances of the AID Delimiter Container parameter, one per Application Identifier (AID) the device should support.

The host uses Command 0xD812 - Start Send File to Device (Unsecured) to load this file type to control the behavior of the device’s EMV kernels.

Table - EMV Entry Point Configuration File Type Header

Tag

Value (hex)

Description

File Type Version

One byte indicating the version of the file type format being used.

0xAA

SHA-1 Hash

20-byte hash of all values that follow

One or more instances of the following entry point tables for supported contactless payment brands. The host should include an Entry Point Table for each transaction type to be supported by each contactless payment brand AID listed in the loaded EMV Processing Configuration File Type.

Mastercard MCL Entry Point Table

Table - Mastercard MCL Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

AID Delimiter Container There can be multiple instances of this in sequence. The contents of the first instance are loaded into Entry Point Table Slot 1, the contents of the second are loaded into Entry Point Table Slot 2, etc.

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x02 = MasterCard Contactless (MCL)

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

02 01 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F1A

Terminal Country Code

08 40

//9F35

Terminal Type

//9F40

Additional Terminal Capabilities

00 00 00 00 00

//9F7E

Mobile Support Indicator

//DF0C

Kernel ID

//DF1B

Kernel Configuration

Bit 8 = MSD Mode Not Supported
Bit 7 = EMV Mode contactless transaction not supported
Bit 6 = On-Device-CVM Supported
Bit 5 = Relay Resistance Protocol Supported
Bit 4..1 = Reserved for future use

//DF2D

Message Hold Time (100 of ms)

00 00 0D

//9F6D

Magnetic Stripe Application Version Number This value only applies when the Kernel Configuration parameter is set to support MSD. The device ignores this value.

00 01

//DF1A

Magnetic Stripe Default UDOL This value only applies when the Kernel Configuration parameter is set to support MSD. The device ignores this value.

9F 6A 04

//DF1E

CVM Capability - CVM Required This value only applies when the Kernel Configuration parameter is set to support MSD. The device ignores this value.

//DF2C

CVM Capability - No CVM Required This value only applies when the Kernel Configuration parameter is set to support MSD. The device ignores this value.

//9F09

EMV Application Version Number

00 02

//DF03

Security Capabilities

Bit 8 = SDA
Bit 7 = DDA
Bit 6 = Card Capture
Bit 5 = Reserved for future use
Bit 4 = CDA
Bits 3..1 = Reserved for future use

//DF17

Card Data Input Capabilities

Bit 8 = Manual Key Entry
Bit 7 = MSR
Bit 6 = ICC
Bits 5..1 = Reserved for future use

//DF18

CVM Capability - CVM Required

Bit 8 = Offline Plaintext PIN
Bit 7 = Enciphered Online PIN
Bit 6 = Signature
Bit 5 = Enciphered Offline PIN
Bit 4 = No CVM
Bits 3..1 = Reserved for future use

//DF19

CVM Capability - No CVM Required

Bit 8 = Offline Plaintext PIN
Bit 7 = Enciphered Online PIN
Bit 6 = Signature
Bit 5 = Enciphered Offline PIN
Bit 4 = No CVM
Bits 3..1 = Reserved for future use

//DF1C

Max Lifetime Torn Transaction(s)

01 2C

//DF1D

Max Number Torn Transaction

//DF20

Terminal Action Code - Default

00 00 00 00 00

//DF21

Terminal Action Code - Denial

00 00 00 00 00

//DF22

Terminal Action Code - Online

00 00 00 00 00

//DF04

Balance Read Before GenAC

//DF05

Balance Read After GenAC

//DF23

Reader Contactless Floor Limit

00 00 00 01 00 00

//DF24

Reader Contactless Transaction Limit (No On-Device CVM)

00 00 00 03 00 00

//DF25

Reader Contactless Transaction Limit (On-Device CVM)

00 00 00 05 00 00

//DF26

Reader CVM Required Limit

00 00 00 00 10 00

//DF27

Timeout Value (ms)

13 88

//DF30

Hold time value before field off (100 of ms)

//DF32

Minimum Relay Resistance Grace Period (100 of micro sec)

00 14

//DF33

Maximum Relay Resistance Grace Period (100 of micro seconds)

00 32

//DF34

Terminal Expected Transmission Time for Relay Resistance C-APDU (100 of micro seconds)

00 12

//DF35

Terminal Expected Transmission Time for Relay Resistance R-APDU (100 of micro seconds)

00 18

//DF36

Relay Resistance Accuracy Threshold (100 of micro seconds)

01 2C

//DF37

Relay Resistance Transmission Time Mismatch Threshold (%)

Visa payWave Entry Point Table

Table - Visa payWave Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x03 = Visa payWave

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

03 05 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F35

Terminal Type

//9F1A

Terminal Country Code

08 40

//9F33

Terminal Capabilities

00 00 00

//9F40

Additional Terminal Capabilities

00 00 00 00 00

//9F66

Terminal Transaction Qualifier

22 00 40 00

//DF1B

Kernel Configuration Byte 1 and further bytes as documented.

00 00 06

//DF2D

Message Hold Time (100 of ms)

00 00 0F

//9F09

EMV Application Version Number

00 01

//DF30

Bitmap Entry Point

Bit 8 = Status Check Support Flag
Bit 7 = Zero Amount Allowed Flag
Bit 6 = Reader Contactless Transaction Limit
Bit 5 = Reader Contactless Floor Limit
Bit 4 = Reader CVM Required Limit

//DF32

Status Zero Amount Allowed Flag

0x01 = Option 1, Online Cryptogram Request
0x02 = Option 2, Not Allowed

//9F1B

Terminal Floor Limit

00 00 00 00

//DF23

Reader Contactless Floor Limit

00 00 00 00 20 00

//DF24

Reader Contactless Transaction Limit

00 00 00 00 50 00

//DF26

Reader CVM Required Limit

00 00 00 00 10 00

American Express Expresspay Entry Point Table

Table - American Express Expresspay Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x04 = Expresspay

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

04 04 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F09

EMV Application Version Number

00 01

//9F1A

Terminal Country Code

08 40

//9F33

Terminal Capabilities

60 28 00

//9F35

Terminal Type

//9F40

Additional Terminal Capabilities

00 00 00 00 00

//9F6D

Contactless Reader Capability Bits 8..7

00 = Expresspay 1.0
01 = Expresspay 2.0 and Expresspay >= 3.x (MSD)
11 = Expresspay >= 3.x(MSD)

Bits 6..1 = 0 (Reserved, not to be configured)

//DF1B

Kernel Configuration (detailed bit definitions)

31 01 00 00 00 00

//DF27

Timeout, Field off request (100 of ms)

//DF2D

Message Hold Time (100 of ms)

00 00 0F

//DF30

Bitmap Entry Point

//DF32

Status Zero Amount Allowed

//DF20

Terminal Action Code - Default

00 00 00 00 00

//DF21

Terminal Action Code - Denial

00 00 00 00 00

//DF22

Terminal Action Code - Online

00 00 00 00 00

//DF23

Reader Contactless Floor Limit

00 00 00 00 20 00

//DF24

Reader Contactless Transaction Limit

00 00 00 01 00 00

//DF26

Reader CVM Required Limit

00 00 00 01 00 00

Discover D-PAS Entry Point Table

Table - Discover D-PAS Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x06 = Discover D-PAS

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

06 06 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F09

EMV Application Version Number

00 01

//9F1A

Terminal Country Code

08 40

//9F33

Terminal Capabilities

00 00 00

//9F35

Terminal Type

//9F66

Terminal Transaction Qualifier

B6 00 C0 00

//DF1B

Kernel Configuration (bit definitions)

//DF1B

Kernel Configuration (Common Kernel Only)

60 00

//DF30

Bitmap Entry Point

//DF32

Status Zero Amount Allowed Flag

//9F1B

Terminal Floor Limit

00 00 00 00

//DF23

Reader Contactless Floor Limit

00 00 00 01 50 00

//DF24

Reader Contactless Transaction Limit

00 00 00 03 00 00

//DF26

Reader CVM Required Limit

00 00 00 00 20 00

China Unionpay Entry Point Table (Common Kernel Only)

Table – China Unionpay Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x07 = China Unionpay

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

07 05 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F09

EMV Application Version Number

00 30

//9F1A

Terminal Country Code

01 56

//9F33

Terminal Capabilities

60 08 00

//9F35

Terminal Type

//9F66

Terminal Transaction Qualifier

36 00 00 80

//DF1B

Kernel Configuration Byte1 and Byte2 (bit definitions)

00 00

//DF20

Terminal Action Code - Default

00 00 00 00 00

//DF21

Terminal Action Code - Denial

00 00 00 00 00

//DF22

Terminal Action Code - Online

00 00 00 00 00

//DF23

Reader Contactless Floor Limit

00 00 00 01 50 00

//DF24

Reader Contactless Transaction Limit

00 00 00 03 00 00

//DF26

Reader CVM Required Limit

00 00 00 01 20 00

//DF30

Bitmap Entry Point

9F1B

Terminal Floor Limit

00 00 3a 98

JCB Entry Point Table (Common Kernel Only)

Table - JCB Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x05 = JCB

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

05 06 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F01

Acquirer Identifier

00 00 00 00 00 01

//9F15

Merchant Category Code

70 32

//9F09

EMV Application Version Number

00 01

//9F1A

Terminal Country Code

03 92

//9F33

Terminal Capability

60 68 08

//9F35

Terminal Type

//9F4E

var

Merchant Name and Location

(example hex provided)

//DF1B

Kernel Configuration Byte1..Byte3 (bit definitions)

7B 00 80

//DF20

Terminal Action Code - Default

90 40 20 80 20

//DF21

Terminal Action Code - Denial

04 10 20 20 20

//DF22

Terminal Action Code - Online

90 60 20 90 20

//DF23

Reader Contactless Floor Limit

00 00 00 01 50 00

//DF24

Reader Contactless Transaction Limit

00 00 00 03 00 00

//DF25

On Device CVM Contactless Transaction Limit

00 00 00 02 50 00

//DF26

Reader CVM Required Limit

00 00 00 01 20 00

//9F1B

Terminal Floor Limit

00 00 3a 98

Interac Flash Entry Point Table (Common Kernel Only)

Table – Interac Flash Entry Point Table

Tag

Len

Value / Description

Typ

Req

Example

FF35

var

/DF0E

Kernel ID, Processing Slot, Transaction Type Byte 1 Kernel ID

0x41 = Interac Flash

Byte 2 Processing Slot to Use See the AID Delimiter Container parameter in EMV Processing Configuration File Type for information about how to identify slots. Byte 3 Transaction Type

0x00 = Purchase
0x01 = Cash
0x02 = Purchase with cashback
0x03 = Refund

41 05 00

/DF0F

var

Payload Delimiter Container Include only one of these containers inside each AID Delimiter Container.

//9F09

EMV Application Version Number

00 02

//9F1A

Terminal Country Code

01 24

//9F33

Terminal Capabilities

60 68 08

//9F35

Terminal Type

//9F40

Additional Terminal Capabilities

E0 00 E0 F0 01

//9F58

Merchant Type Indicator

//9F5D

Receipt Limit

00 00 00 00 50 00

//9F5E

Terminal Option Status Byte1/Byte2 (bit definitions)

E0 00

//9F5F

Reader Contactless Floor Limit

00 00 00 01 00 00

//DF1B

Kernel Configuration Byte1/Byte2 (bit definitions)

02 34

//DF20

Terminal Action Code - Default

00 00 00 00 00

//DF21

Terminal Action Code - Denial

00 00 00 00 00

//DF22

Terminal Action Code - Online

00 00 00 00 00

//9F1B

Terminal Floor Limit

00 00 1F 40

EMV Configuration CA Public Keys File Type

The host can load this file type to control the behavior of the device’s EMV contact and contactless kernels when the device should support Offline Data Authentication (ODA). Populate all values from information provided by each payment brand that should be supported by the device. The host can load this file using Command 0xD812 - Start Send File to Device (Unsecured).

contact MagTek Support Services. The MagTek tools expect the spreadsheet to be formatted format as shown in Table 41. Each CA Key to be supported is defined in a tab of the Excel file.

Table - EMV Configuration CA Keys File Type

Tag

Len

Value / Description

Typ

Req

Example

DFDF79

Registered Application ID (RID)

A0 00 00 00 04

DFDF7A

CA Public Key Index

DFDF7B

var

CA Public key Modulus

B8 04 8A … D5 97

DFDF7C

01 or 03

CA Public Key Exponent

DFDF7D

CA Public Key Checksum

EB FA 0D 5D 06 D8 CE 70 2D A3 EA E8 90 70 1D 45 E2 74 C8 45

The MagTek tool converts the spreadsheet data into the format shown in CA Keys Raw Format.

Table - CA Keys Raw Format

CA Keys Raw Format

RID (5 Bytes) As defined by the payment brand.

Index (1 Byte) As defined by the payment brand.

Exponent Length (1 Byte)

0x01
0x03

Key Length (1 Byte), Max of 248 bytes per EMVCo specifications

Exponent (1 or 3 Bytes)

0x03
0x010001

Modulus As defined by the payment brand.

Additional CA Keys, repeating from RID through Modulus, as needed.

SHA-1 hash of all data in the file

EMV American Express DRL Configuration File Type (Not Supported on Expresspay 4.x)

The host can load this file type to control the behavior of the device’s American Express contactless kernel when the card sends tag 9F70 and one or more DRL is defined.

The host can load it using Command 0xD812 - Start Send File to Device (Unsecured). See the Expresspay 4.0.2 specification for functional details.

MagTek provides tools that allow these settings to be loaded using a Microsoft Excel spreadsheet in xlsx format for more convenient authoring, review, and change tracking. For a reference sample spreadsheet, contact MagTek Support Services. The MagTek tools expect the spreadsheet to be formatted as shown in Table 43. Each DRL to be supported is defined in a tab of the Excel file.

Table - EMV Configuration American Express DRL Set File Type

Tag

Len

Value / Description

Typ

Req

Example

DF23

Reader Contactless Floor Limit

00 00 00 00 15 00

DF24

Reader Contactless Transaction Limit

00 00 00 00 05 00

DF26

Reader CVM Required Limit

00 00 00 00 10 00

The MagTek tool converts the spreadsheet data into the raw format shown in Table 44:

Table - Raw EMV Configuration American Express DRL Set File Type

Tag

Len

Value / Description

Typ

Req

Example

File Type Version One byte indicating the version of the file type format being used.

0xAA

SHA-1 Hash 20 byte hash of all values that follow

FF37

var

DRL Configuration Container

/FF36

var

DRL Set Container

//DF23

Reader Contactless Floor Limit

00 00 00 00 15 00

//DF24

Reader Contactless Transaction Limit

00 00 00 00 05 00

//DF26

Reader CVM Required Limit

00 00 00 00 10 00

Additional instances of DRL Set Container as needed

Last updated 21 days ago