This message occurs when an extended response is received from the device.
Parameter
Description
obj
Byte array containing the extended response data received from the device. The first two bytes represent the result codes for the extended command.
The next two bytes (most significant byte first) indicate the total length of the following data in bytes.
OnDeviceState (EMV Device Only)
This message occurs when the device changes state.
The bits of Session State mean the following:
Pwr Chg:
1 = Power Change Occurred (occurs on Power up or after a USB resume)
Card Data:
0 = Certificate does not exist in the device
1 = Certificate exists in the device
This message occurs when the card status has changed.
This message occurs when the device sends card data.
This message occurs when the device sends the response to a PIN request.
This message occurs when the signature state has change.
This message occurs when the device sends the response to a signature request.
This message occurs when the encrypted data state has changed.
This message occurs when the device returns encrypted data.
1
Session State
Pwr Chg
RFU
RFU
RFU
Card Data
MSRP AN
EXPAN
Amt
1 = Card Data Available
MSR PAN:
1 = PAN Parsed from Card
EXPAN:
1 = External PAN Sent
Amt:
1 = Amount sent
3
Device Certificate Status
MSR CRL
PIN CRL
TLS (RSA)C
ert
Manufa cturer Unbind
MSR
Key Loader CA
Device CA
Device CA
2
Card Type
2
PIN BLOCK
Encryption Type
0xxx xxxx = Fixed key
1xxx xxxx = DUKPT key
xx00 xxxx = TDES
xx01 xxxx = AES128
xx10 xxxx = AES256
xxxx xx00 = Data variant
xxxx xx01 = PIN variant
xxxx xx10 = MAC variant
3 - 14
PIN KSN.
PIN KSN.
If fixed PIN Key is used, KSN is all zeroes.
14 - 21
EPB
Encrypted PIN Block (EPB). If PIN entry was successful, this contains the PIN data, encrypted using the PIN variant of the current PIN DUKPT working key. Format after decryption depends on the PIN Option the host specified, and on the device’s Session State:
If the Session State indicates there is no PAN available (from card swipe or sent via command), the device creates the EPB using ISO Format 1.
If there is a PAN, the device creates the EPB using the PIN Option the host specified in the command.
2
Signature length (low byte)
3
Signature length (high byte)
2
Input Data length (low byte)
3
Input Data length (high byte)
11 - n
Encrypted Input Data
The encrypted data encrypted using the DATA variant of the current DATA DUKPT working key.
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Device State
0x00 = Idle 0x01 = Session
0x02 = Wait For Card 0x03 = Wait For PIN
0x04 = Wait For Selection
0x05 = Displaying Message
0x06 = Test (Reserved for future use)
0x07 = Manual Card Entry
0x08 = Wait for Signature Capture (SC-S Only | SC-F Only)
0x09 = Wait Cardholder Entry
0x0A = Chip Card
0x0B = ICC Kernel Test
0x0C = EMV Transaction
0x0D = Show PAN
Offset
Field Name
Bit 7
6
5
4
3
2
1
Offset
Field Name
Value
2
Device Status
0x00 = OK. Otherwise, the possible values are listed below:
Bit 7 = Device Error Status:
1 = Device Error
Bit 6 = Authentication Status:
0 = Not Authenticated
1 = Authenticated
Bit 5 = 0
Bit 4 = Tamper:
0 = Normal
1 = Tamper Detected
Bits [3,2] = MSR Key Status:
00 = MSR Key OK
01 = MSR Key Exhausted
10 = No MSR Key
11 = MSR Key Not Bound
Bits [1,0] = PIN Key Status:
00 = PIN Key OK
01 = PIN Key Exhausted
10 = No PIN Key
11 = PIN Key Not Bound
Offset
Field Name
Bit 7
6
5
4
3
2
1
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Operation Status
1
Card Status
Parameter
Description
obj
Byte array containing the data received from the device.
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Operation Status
1
PIN BLOCK
Format
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Operation Status
1
Reserved
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Message
This Signature is an array of bytes.
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Operation Status
1
Reserved
Parameter
Description
obj
Byte array containing the data received from the device.
Offset
Field Name
Value
0
Operation Status
1 - 10
KSN.
OnCardStatus (EMV Device Only)
1.4 OnCardData (EMV Device Only)
OnPINResponse (EMV Device Only)
OnSignatureState (EMV Device Only)
OnSignature (EMV Device Only)
OnEncryptedDataState (EMV Device Only)
OnEncryptedData (EMV Device Only)
0
0
0000 0000 = ISO Format 0 (PAN Required)
0000 0001 = ISO Format 1 (No PAN Required)
0000 0011 = ISO Format 3 (PAN Required)
0000 0100 = ISO Format 4 (Not Supported)
KSN.
If fixed Key is used, KSN is all zeroes.
F8<len> /*container tag for encryption */
DFDF59(Encrypted Data Primitive)<len><Encrypted Data val (Decrypt data to read tags)>
DFDF56(Encrypted Transaction Data KSN)<len><val>
DFDF57(Encrypted Transaction Data Encryption Type)<val>
DFDF58(# of bytes of padding in DFDF59)<len><val>
FC<len> /*container tag for encrypted generic data */
F4<len>/* container tag for encrypted MSR data */
DFDF36 <EncT1status><len><val>
DFDF37 <EncT1data><len><val>
DFDF38 <EncT2status><len><val>
DFDF39 <EncT2data><len><val>
DFDF3A <EncT3status><len><val>
DFDF3B <EncT3data><len><val>
DFDF3C <Encrypted Magneprint Data><len><val>
DFDF43 <Magneprint Status Data><len><val>
DFDF50(MSR KSN Data)<len><val> /*sent in the clear*/
DFDF51(MSR EncryptionType)<len><val>