EMV Entry Point 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.

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.

T

R

/DF0E

03

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

B

R

02 01 00

/DF0F

var

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

T

R

//9F1A

02

Terminal Country Code

B

R

08 40

//9F35

01

Terminal Type

B

R

21

//9F40

05

Additional Terminal Capabilities

B

R

00 00 00 00 00

//9F7E

01

Mobile Support Indicator

B

R

01

//DF0C

01

Kernel ID

B

R

02

//DF1B

01

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

B

R

20

//DF2D

03

Message Hold Time (100 of ms)

B

R

00 00 0D

//9F6D

02

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

B

R

00 01

//DF1A

03

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

B

R

9F 6A 04

//DF1E

01

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

B

R

00

//DF2C

01

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

B

R

00

//9F09

02

EMV Application Version Number

B

R

00 02

//DF03

01

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

B

R

08

//DF17

01

Card Data Input Capabilities

  • Bit 8 = Manual Key Entry

  • Bit 7 = MSR

  • Bit 6 = ICC

  • Bits 5..1 = Reserved for future use

B

R

60

//DF18

01

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

B

R

28

//DF19

01

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

B

R

08

//DF1C

02

Max Lifetime Torn Transaction(s)

B

R

01 2C

//DF1D

01

Max Number Torn Transaction

B

R

00

//DF20

05

Terminal Action Code - Default

B

R

00 00 00 00 00

//DF21

05

Terminal Action Code - Denial

B

R

00 00 00 00 00

//DF22

05

Terminal Action Code - Online

B

R

00 00 00 00 00

//DF04

0

Balance Read Before GenAC

B

R

//DF05

0

Balance Read After GenAC

B

R

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 01 00 00

//DF24

06

Reader Contactless Transaction Limit (No On-Device CVM)

B

R

00 00 00 03 00 00

//DF25

06

Reader Contactless Transaction Limit (On-Device CVM)

B

R

00 00 00 05 00 00

//DF26

06

Reader CVM Required Limit

B

R

00 00 00 00 10 00

//DF27

02

Timeout Value (ms)

B

R

13 88

//DF30

01

Hold time value before field off (100 of ms)

B

R

0D

//DF32

02

Minimum Relay Resistance Grace Period (100 of micro sec)

B

R

00 14

//DF33

02

Maximum Relay Resistance Grace Period (100 of micro seconds)

B

R

00 32

//DF34

02

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

B

R

00 12

//DF35

02

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

B

R

00 18

//DF36

02

Relay Resistance Accuracy Threshold (100 of micro seconds)

B

R

01 2C

//DF37

01

Relay Resistance Transmission Time Mismatch Threshold (%)

B

R

32

Visa payWave Entry Point Table

Table - Visa payWave 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.

T

R

/DF0E

03

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

B

R

03 05 00

/DF0F

var

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

T

R

//9F35

01

Terminal Type

B

R

21

//9F1A

02

Terminal Country Code

B

R

08 40

//9F33

03

Terminal Capabilities

B

R

00 00 00

//9F40

05

Additional Terminal Capabilities

B

R

00 00 00 00 00

//9F66

04

Terminal Transaction Qualifier

B

R

22 00 40 00

//DF1B

03

Kernel Configuration Byte 1 and further bytes as documented.

B

R

00 00 06

//DF2D

03

Message Hold Time (100 of ms)

B

R

00 00 0F

//9F09

02

EMV Application Version Number

B

R

00 01

//DF30

01

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

B

R

F8

//DF32

01

Status Zero Amount Allowed Flag

  • 0x01 = Option 1, Online Cryptogram Request

  • 0x02 = Option 2, Not Allowed

B

R

02

//9F1B

04

Terminal Floor Limit

B

R

00 00 00 00

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 00 20 00

//DF24

06

Reader Contactless Transaction Limit

B

R

00 00 00 00 50 00

//DF26

06

Reader CVM Required Limit

B

R

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

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.

T

R

/DF0E

03

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

B

R

04 04 00

/DF0F

var

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

T

R

//9F09

02

EMV Application Version Number

B

R

00 01

//9F1A

02

Terminal Country Code

B

R

08 40

//9F33

03

Terminal Capabilities

B

R

60 28 00

//9F35

01

Terminal Type

B

R

21

//9F40

05

Additional Terminal Capabilities

B

R

00 00 00 00 00

//9F6D

01

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)

B

R

C0

//DF1B

06

Kernel Configuration (detailed bit definitions)

B

R

31 01 00 00 00 00

//DF27

01

Timeout, Field off request (100 of ms)

B

R

20

//DF2D

03

Message Hold Time (100 of ms)

B

R

00 00 0F

//DF30

01

Bitmap Entry Point

B

R

F8

//DF32

01

Status Zero Amount Allowed

B

R

01

//DF20

05

Terminal Action Code - Default

B

R

00 00 00 00 00

//DF21

05

Terminal Action Code - Denial

B

R

00 00 00 00 00

//DF22

05

Terminal Action Code - Online

B

R

00 00 00 00 00

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 00 20 00

//DF24

06

Reader Contactless Transaction Limit

B

R

00 00 00 01 00 00

//DF26

06

Reader CVM Required Limit

B

R

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

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.

T

R

/DF0E

03

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

B

R

06 06 00

/DF0F

var

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

T

R

//9F09

02

EMV Application Version Number

B

R

00 01

//9F1A

02

Terminal Country Code

B

R

08 40

//9F33

03

Terminal Capabilities

B

R

00 00 00

//9F35

01

Terminal Type

B

R

21

//9F66

04

Terminal Transaction Qualifier

B

R

B6 00 C0 00

//DF1B

01

Kernel Configuration (bit definitions)

B

R

60

//DF1B

02

Kernel Configuration (Common Kernel Only)

B

R

60 00

//DF30

02

Bitmap Entry Point

B

R

F8

//DF32

01

Status Zero Amount Allowed Flag

B

R

01

//9F1B

06

Terminal Floor Limit

B

R

00 00 00 00

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 01 50 00

//DF24

06

Reader Contactless Transaction Limit

B

R

00 00 00 03 00 00

//DF26

06

Reader CVM Required Limit

B

R

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

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.

T

R

/DF0E

03

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

B

R

07 05 00

/DF0F

var

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

T

R

//9F09

02

EMV Application Version Number

B

R

00 30

//9F1A

02

Terminal Country Code

B

R

01 56

//9F33

03

Terminal Capabilities

B

R

60 08 00

//9F35

01

Terminal Type

B

R

21

//9F66

04

Terminal Transaction Qualifier

B

R

36 00 00 80

//DF1B

02

Kernel Configuration Byte1 and Byte2 (bit definitions)

B

R

00 00

//DF20

05

Terminal Action Code - Default

B

R

00 00 00 00 00

//DF21

05

Terminal Action Code - Denial

B

R

00 00 00 00 00

//DF22

05

Terminal Action Code - Online

B

R

00 00 00 00 00

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 01 50 00

//DF24

06

Reader Contactless Transaction Limit

B

R

00 00 00 03 00 00

//DF26

06

Reader CVM Required Limit

B

R

00 00 00 01 20 00

//DF30

01

Bitmap Entry Point

B

R

78

9F1B

04

Terminal Floor Limit

B

R

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

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.

T

R

/DF0E

03

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

B

R

05 06 00

/DF0F

var

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

T

R

//9F01

06

Acquirer Identifier

B

R

00 00 00 00 00 01

//9F15

02

Merchant Category Code

B

R

70 32

//9F09

02

EMV Application Version Number

B

R

00 01

//9F1A

02

Terminal Country Code

B

R

03 92

//9F33

03

Terminal Capability

B

R

60 68 08

//9F35

01

Terminal Type

B

R

21

//9F4E

var

Merchant Name and Location

B

R

(example hex provided)

//DF1B

03

Kernel Configuration Byte1..Byte3 (bit definitions)

B

R

7B 00 80

//DF20

05

Terminal Action Code - Default

B

R

90 40 20 80 20

//DF21

05

Terminal Action Code - Denial

B

R

04 10 20 20 20

//DF22

05

Terminal Action Code - Online

B

R

90 60 20 90 20

//DF23

06

Reader Contactless Floor Limit

B

R

00 00 00 01 50 00

//DF24

06

Reader Contactless Transaction Limit

B

R

00 00 00 03 00 00

//DF25

06

On Device CVM Contactless Transaction Limit

B

R

00 00 00 02 50 00

//DF26

06

Reader CVM Required Limit

B

R

00 00 00 01 20 00

//9F1B

04

Terminal Floor Limit

B

R

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

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.

T

R

/DF0E

03

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

B

R

41 05 00

/DF0F

var

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

T

R

//9F09

02

EMV Application Version Number

B

R

00 02

//9F1A

02

Terminal Country Code

B

R

01 24

//9F33

03

Terminal Capabilities

B

R

60 68 08

//9F35

01

Terminal Type

B

R

21

//9F40

05

Additional Terminal Capabilities

B

R

E0 00 E0 F0 01

//9F58

01

Merchant Type Indicator

B

R

03

//9F5D

06

Receipt Limit

B

R

00 00 00 00 50 00

//9F5E

02

Terminal Option Status Byte1/Byte2 (bit definitions)

B

R

E0 00

//9F5F

06

Reader Contactless Floor Limit

B

R

00 00 00 01 00 00

//DF1B

02

Kernel Configuration Byte1/Byte2 (bit definitions)

B

R

02 34

//DF20

05

Terminal Action Code - Default

B

R

00 00 00 00 00

//DF21

05

Terminal Action Code - Denial

B

R

00 00 00 00 00

//DF22

05

Terminal Action Code - Online

B

R

00 00 00 00 00

//9F1B

04

Terminal Floor Limit

B

R

00 00 1F 40

Last updated