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
2-byte MSB message length excluding padding and CBC-MAC
F9
var
Container for MAC structure and generic data
T
R
/DFDF54
var
MAC KSN
B
R
/DFDF55
01
MAC Encryption Type See section 4.4 Encryption Type for a list of valid values.
B
R
/DFDF25
var
Device Serial Number (IFD Serial Number)
B
R
/FA
var
Container for Generic Data
T
R
//F0
var
Transaction Results
T
R
///F1
var
Container for Status Data
T
R
////DFDF1A
01
Transaction Status
0x00 = Accept
0x01 = Decline
0x02 = Error
B
R
////DFDF1B
01
Additional Transaction Information 0x00 (MAGTEK INTERNAL ONLY FOR NOW)
0x00 = No additional information
0x31 = EMV Application not selected
0x32 = Error transaction in progress
0x33 = Error invalid PSE format
0x34 = EMV Terminal application list is empty
0x35 = Candidate list is empty
0x36 = No transaction
0x37 = No common EMV applications
0x38 = Transaction canceled
0x39 = Aid parse error
0x3A = Code table index not found
0x3B = Error no more record
0x3C = EMV e overflow
B
R
///F8
var
Container for Encrypted Data
T
R
////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.
B
R
////DFDF56
var
Encrypted Transaction Data KSN
B
R
////DFDF57
01
Encrypted Transaction Data Encryption Type See section 4.4 Encryption Type for a list of valid values.
B
R
////DFDF58
01
Number of padding bytes added to DFDF59 value to force length to a multiple of 8 bytes
B
R
///F7
var
Merchant Data This contains an instance of Merchant Data Container.
T
R
/FE
Var
VAS Data Container See Table 25 – VAS Data Container Payload
T
O
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).
Table – EMV Batch Data (DynaPro Format) DFDF59 Decrypted Contents
FC
var
Decrypted Data Container
T
/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.
T
//DF29
08
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
B
O
/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.
T
O
null
/F4
var
Container for encrypted MSR data (MSR Only)
T
O
//DFDF36
01
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]
B
O
//DFDF37
var
Encrypted Track 1 Data (MSR Only)
B
O
//DFDF38
01
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]
B
O
//DFDF39
var
Encrypted Track 2 Data (MSR Only)
B
O
//DFDF3A
01
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]
B
O
//DFDF3B
var
Encrypted Track 3 Data (MSR Only)
B
O
//DFDF3C
var
Encrypted MagnePrint Data (MSR Only) Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.
B
O
//DFDF43
04
MagnePrint Status Data (MSR Only) Only included for MSR swipe transactions and when Track Data and Magneprint are using the same KSN.
B
O
//DFDF50
var
MSR KSN Data (MSR Only)
B
O
//DFDF51
01
MSR Encryption Type (MSR Only) See section 4.4 Encryption Type for a list of valid values.
B
O
/FF73
var
Container for Encrypted MagnePrint Data (MSR Only) Only included when Track Data and MagnePrint encryption keys are using different KSN
T
O
//DFDF3C
var
Encrypted MagnePrint Data (MSR Only) Only included for MSR swipe transactions.
B
O
//DFDF43
04
MagnePrint Status Data (MSR Only) Only included for MSR swipe transactions.
B
O
//DFDF50
var
MSR KSN Data (MSR Only) Key Serial Number for the key the host should use to decrypt Encrypted MagnePrint Data.
B
O
//DFDF51
01
MSR Encryption Type (MSR Only) See section 4.4 Encryption Type for a list of valid values.
B
O
/F5
00
Container for Encrypted PIN Data (Touch Only)
T
O
//DF71
00
PIN Block Format (Touch Only)
0x00 = ISO Format 0
0x01 = ISO Format 1
0x03 = ISO Format 3
0x04 = ISO Format 4
B
O
//99
00
Encrypted PIN Data (Touch Only)
B
O
//DFDF41
00
PIN KSN Data (Touch Only)
B
O
//DFDF42
00
PIN Encryption Type (Touch Only) See section 4.4 Encryption Type for a list of valid values.
B
O
null
(var)
Padding to force DFDF59 plus padding to be a multiple of 8 bytes
B
Table - EMV Batch Data (DynaPro Format) DFDF59 Decrypted Contents
FC
var
Decrypted Data Container
T
/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.
T
/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.
T
O
null
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.
B
/FE
Var
VAS Data Container See Table 25 – VAS Data Container Payload
T
O
/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
DFDF30
Masked Track 1 Status (MSR Only)
0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled
Device
b
1
DFDF31
Masked Track 1 Data (MSR Only)
Device
b
var
DFDF32
Masked Track 2 Status (MSR Only)
0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled
Device
b
1
DFDF33
Masked Track 2 Data (MSR Only)
Device
b
var
DFDF34
Masked Track 3 Status (MSR Only)
0x00 = OK
0x01 = Empty
0x02 = Error
0x03 = Disabled
Device
b
1
DFDF35
Masked Track 3 Data (MSR Only)
Device
b
var
DFDF40
Signature Status
0x00 = Signature Not Required
0x01 = Signature Required
0x02 = Signature Available
0x03 = Signature Succeeded
0x04 = Signature Failed
Device
b
1
DFDF3E
Signature Capture Data (Touch Only) This is a blob that consists of a raw list of point coordinates representing the signature. Each coordinate is 2 bytes long, where the first byte is the X coordinate of that point, and the second byte is the Y coordinate of that point.
Device
b
0..2000
5F25
EMV Application Effective Date
Card
n6
3
5F24
EMV Application Expiration Date
Card
n6
3
89
Authorization Code
Device
b
6
5F2A
Transaction Currency Code
Card
n3
2
9F02
Amount, authorized
Device
n12
6
9F03
Amount, other
Device
n12
6
9F06
AID - terminal
Device
b
5..16
9F12
EMV Application Preferred Name
Card
ans
1..16
9F1C
Terminal ID
Device
an 8
8
9F39
POS Entry Mode
Device
n2
1
9C
Transaction Type
Device
n2
1
9F34
Indicates the results of the last CVM performed
Device
b
3
5F57
Account Type
Device
n2
1
5F34
PAN Sequence Number
Card
n2
1
DFDF4D
Masked ICC Track 2 Data
Card
ans
30..38
Last updated