(7/30/26 Draft version) Transaction Information Update - Notification 0x0101
This notification reports information about progress and state changes that occur during a transaction.
For this notification, Notification Detail described in Notification Message contains one byte each, to indicate:
The Payment Technology (PT) involved
The Reason (Rsn) for the notification
Detail (Det) about the notification that has different meanings depending on the Reason
An Extra field (Ext) that has different meanings depending on the Reason
Notification Detail Codes - Manual Card Entry
Payment Technology 0x07 Manual Card Entry (MCE) contains transaction notification detail codes involving manual card entry (MCE Only).
Reasons:
0x01 = Card Event;
0x08 = Data Update;
0x10 = State Update.
0x07
0x01
0x01
0x00
Manual Card Entry, Card Event, Data Entered, Reserved (MCE Only)
0x07
0x08
0x02
0x02
Manual Card Entry, Data Update, ARQC Update (Quick Chip), Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (MCE Only).
0x07
0x08
0x03
0x02
Manual Card Entry, Data Update, Batch Data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (MCE Only).
Notification Detail Codes - Magnetic Stripe Reader
Payment Technology 0x08 Magnetic Stripe Reader (MSR) contains transaction notification detail codes involving magnetic stripe cards (MSR Only).
Reasons:
0x01 = Card Event;
0x08 = Data Update;
0x10 = State Update
0x08
0x01
0x01
0x00
MSR, Card Event, Swiped, Reserved (MSR Only)
0x08
0x01
0x02
0x00
MSR, Card Event, Inserted, Reserved (MSR Only)
0x08
0x01
0x03
0x00
MSR, Card Event, Removed, Reserved (MSR Only)
0x08
0x01
0x04
0x00
MSR, Card Event, Detected, Reserved
0x08
0x08
0x02
0x02
MSR, Data Update, ARQC Update (Quick Chip), Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (MSR Only).
0x08
0x08
0x03
0x02
MSR, Data Update, Batch Data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (MSR Only).
Notification Detail Codes - EMV Contact
Payment Technology 0x10 EMV Contact contains transaction notification detail codes involving contact chip cards (EMV Contact Only).
Reasons:
0x01 = Card Event;
0x02 = Online PIN Event;
0x08 = Data Update;
0x10 = State Update
0x10
0x01
0x02
0x00
EMV Contact, Card Event, Inserted, Reserved (EMV Contact Only)
0x10
0x01
0x03
0x00
EMV Contact, Card Event, Removed, Reserved (EMV Contact Only)
0x10
0x01
0x04
0x00
EMV Contact, Card Event, Detected, Reserved (EMV Contact Only)
0x10
0x02
0x06
0x01
EMV Contact, Online PIN Event, PIN Entry, PIN Pad Error (EMV Contact Only)
0x10
0x02
0x06
0x02
EMV Contact, Online PIN Event, PIN Entry, PIN Block Encryption Error (EMV Contact Only)
0x10
0x08
0x02
0x02
EMV Contact, Data Update, ARQC Update (Quick Chip), Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contact Only).
0x10
0x08
0x03
0x02
EMV Contact, Data Update, Batch Data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contact Only).
Notification Detail Codes - EMV Contactless
Payment Technology 0x20 EMV Contactless contains transaction notification detail codes involving contactless cards and contactless payment devices.
Reasons:
0x01 = Card Event;
0x02 = Online PIN Event;
0x08 = Data Update;
0x10 = State Update
0x00
0x10
0x01
0x00
None, State Update, Transaction Started by Device, Legacy EMV Flow (Touch Only)
0x00
0x10
0x01
0x01
None, State Update, Transaction Started by Device, Quick Chip Flow (Touch Only)
0x00
0x10
0x02
0x00
None, State Update, Transaction Canceled, Reserved (Touch Only)
0x20
0x01
0x03
0x00
EMV Contactless, Card Event, Removed, Reserved (EMV Contactless Only)
0x20
0x01
0x04
0x00
EMV Contactless, Card Event, Detected, EMV (EMV Contactless Only)
0x20
0x01
0x04
0x01
EMV Contactless, Card Event, Detected, NFC/MIFARE Ultralight (EMV Contactless Only)
0x20
0x01
0x04
0x02
EMV Contactless, Card Event, Detected, MIFARE Classic 1K (EMV Contactless Only)
0x20
0x01
0x04
0x03
EMV Contactless, Card Event, Detected, MIFARE Classic 4K (EMV Contactless Only)
0x20
0x01
0x04
0x04
EMV Contactless, Card Event, Detected, MIFARE DESFire Light (EMV Contactless Only)
0x20
0x01
0x04
0x05
EMV Contactless, Card Event, Detected, MIFARE MINI® (EMV Contactless Only)
0x20
0x01
0x04
0x06
EMV Contactless, Card Event, Detected, MIFARE Plus EV1 (EMV Contactless Only)
0x20
0x01
0x04
0x07
EMV Contactless, Card Event, Detected, MIFARE Plus EV2 (EMV Contactless Only)
0x20
0x01
0x04
0x08
EMV Contactless, Card Event, Detected, MIFARE Plus SE (EMV Contactless Only)
0x20
0x01
0x04
0x09
EMV Contactless, Card Event, Detected, MIFARE Plus X (EMV Contactless Only)
0x20
0x01
0x04
0x0A
EMV Contactless, Card Event, Detected, MIFARE DESFire EV1 (EMV Contactless Only)
0x20
0x01
0x04
0x0B
EMV Contactless, Card Event, Detected, MIFARE DESFire EV2 (EMV Contactless Only)
0x20
0x01
0x04
0x0C
EMV Contactless, Card Event, Detected, MIFARE DESFire EV3 (EMV Contactless Only)
0x20
0x01
0x05
0x00
EMV Contactless, Card Event, Collision, Reserved (EMV Contactless Only)
0x20
0x01
0x10
0x02
EMV Contactless, Card Event, Apple VAS Error, Data Attached — device includes additional data defined in Table 317 – VAS Error Report in the Notification Payload portion of the Notification Message (Apple VAS Only).
0x20
0x01
0x20
0x02
EMV Contactless, Card Event, Google Smart Tap Error, Data Attached — device includes additional data defined in Table 317 – VAS Error Report in the Notification Payload portion of the Notification Message (Google Smart Tap Only).
0x20
0x02
0x06
0x01
EMV Contactless, Online PIN Event, PIN Entry, PIN Pad Error (EMV Contactless Only)
0x20
0x02
0x06
0x02
EMV Contactless, Online PIN Event, PIN Block Encryption Error (EMV Contactless Only)
0x20
0x08
0x02
0x02
EMV Contactless, Data Update, ARQC Update (Quick Chip), Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contactless Only).
0x20
0x08
0x03
0x02
EMV Contactless, Data Update, Batch Data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contactless Only).
0x20
0x08
0x04
0x02
EMV Contactless, Data Update, NFC UID data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contactless Only).
0x20
0x08
0x07
0x02
EMV Contactless, Data Update, GPO Response, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contactless Only).
0x20
0x08
0x08
0x02
EMV Contactless, Data Update, MIFARE Card Data, Data Attached — device includes additional data defined in Table 314 in the Notification Payload portion of the Notification Message (EMV Contactless Only).
Notification Detail Codes - Barcode Reader
Payment Technology 0x30 Barcode Reader contains transaction notification detail codes involving barcodes (BCR Only). Reason: 0x01 = Barcode Event.
30
01
01
00
(BCR Only) Barcode Reader, Barcode Event, Read, Reserved
30
08
00
02
Barcode Reader, Barcode Update, Type, Data Attached
Type 0x00 = Unknown
Type 0x01 = MagTek
Type 0x02 = EMV
The barcode reader has successfully read a barcode. In this case, the device includes barcode data in the Notification Payload portion of the Notification Message. If the data is encrypted, the data is in the format described in Table 7.4‑5. Data that is not encrypted is in the format described in Table 7.4‑6
(BCR Only)
Barcode Reader, Barcode Event, MagTek Blob Type, Data Attached
In this case, the device includes additional data, defined in Table 7.1‑2, in the Notification Payload portion of the Notification Message
Notification Detail Codes - mDOC
Payment Technology 0x40 Mobile Document (mDoc) contains transaction notification detail codes involving Mobile Document.
· Reason 0x01 = Engagement Event
· Reason 0x08 = Data Retrieval
· Reason 0x09 = Subscription
PT
Rsn
Det
Ext
Meaning
40
01
01
00
mDoc, Engagement Event, QR Code, Reserved
40
01
02
00
mDoc, Engagement Event, NFC, Reserved
40
08
01
02
mDoc, Data Retrieval, Type, Data Attached
· Type 0x01 = SessionData
· Type 0x02 = SessionData Failure
40
09
01
01
mDoc, Subscription, Expiration, Warning
40
09
01
02
mDoc, Subscription, Expiration, Expired
mDOC Encrypted Notification - mDL/mPass
Tag
Len
Value / Description
Typ
Req
Default
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
B
R
/F8
var
Container for Encrypted Data
T
R
//DFDF59
var
Encrypted Data Primitive
Decrypt the value of this TLV data object using the algorithm and variant specified in the Encrypted Data KSN parameter and the Encrypted Data Encryption Type parameter to read its contents.
B
R
//DFDF56
var
Encrypted Data KSN
B
R
//DFDF57
01
Encrypted Data Encryption Type
B
R
//DFDF58
01
Number of Padding Bytes
Number of bytes added to DFDF59 value to force its length to a multiple of 16 bytes for AES.
B
R
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 (for TDES) or 16 (for AES) bytes. It is a requirement of CMAC algorithm.
Four-byte CMAC. The host should calculate the CMAC and verify that it matches.
mDL DFDF59 Decrypted Contents
Tag
Len
Value / Description
Typ
Req
Default
FD
var
Decrypted/Raw Data Container
Inside this container, the device inserts TLV data objects of response data of various nameSpaces defines in ISO-18013 and ISO-23220.
T
R
/9F01 to
/9F40
var
Response data of nameSpace “org.iso.18013.5.1”.
B
O
/9F41 to
/9F60
var
Response data of nameSpace “org.iso.18013.5.1.aamva”.
B
O
/9F61 to
/9F80
var
Response data of nameSpace “org.iso.23220.1”.
B
O
Padding to force DFDF59 plus padding to be a multiple of 8 (for TDES) or 16 (for AES) bytes for encryption.
Response. Command has started running:
Notification 0x0101 (Engagement event with QR Code)
Notification 0x0101 (Engagement event with NFC)
Notification 0x0101, Tagged Data attached, Security is enabled (for both QR Code and NFC modes)
Case #1: Both Encryption and MACing are using TDES key
Case #2: Both Encryption and MACing are using AES key
Decrypted Data:
Notification 0x0101, Tagged Data attached, Security is disabled (for both QR Code and NFC modes)
Notification 0x0101, SessionData failure has been detected (for both QR Code and NFC modes)
Notification 0x0105, Timeout has occurred (for both QR Code and NFC modes)
Notification 0x0105, Host Cancel (CMD 0x1008) (for both QR Code and NFC modes)
Notification 0x0105, User Cancel (Display ONLY) (for both QR Code and NFC modes)
Notification Payload for mDoc Subscription Warning
Level 5 Heading: Notification 0101 = Transaction Information Update
Tag
Len
Value / Description
Typ
Req
Default
84
var
Notification Payload
/81
1
Configured Warning Days (from OID 1.2.9.1.1.2 Byte 0)
B
R
/82
1
Calculated Days Remaining Until ValidTo
B
R
/83
8
Configured ValidTo Epoch time (uint64, little-endian)
B
R
Example inner payload shape under 84:
81 01 05 82 01 01 83 08 00 65 5D 6A 00 00 00 00
(5 warn days, 1 day remaining, ValidTo = 2026-07-20 00:00:00 UTC)
Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached
Beginning of Notification Message
0101 = DynaPro Format Transaction Data
84
var
Transaction Data
B
R
/null
(v)
EMV ARQC Type data blob, if the notification is an ARQC Update (Quick Chip) notification.
EMV Batch Data Type data blob, if the notification is a Batch Data notification.
Decoded raw barcode data, if the notification is a Barcode event notification. If the barcode data is Base64 encoded, the device sends the decoded version in binary format.
NFC UID Type reports the unique ID from the NFC tag (EMV Contactless Only)
GPO Response Type reports the card’s GPO Response (EMV Contactless Only)
B
O
End of Notification Message
Notification Payload for Barcode Reader, Barcode Event, Type (Encrypted Data Attached)
Beginning of Notification Message
1805 = User Interface Operation Complete
84
var
Notification Payload
B
R
/DFDF59
var
Encrypted Data Primitive
Decrypt the value of this TLV data object using the algorithm and variant specified in the Encrypted Data KSN parameter and the Encrypted Data Encryption Type parameter to read its contents. The format of the decrypted data is shown in Table 316.
B
R
/DFDF50
var
Encrypted Data KSN
B
R
/DFDF51
01
Encrypted Data Encryption Type — See section 4.4 Encryption Type for a list of valid values.
B
R
End of Notification Message
Notification Payload for Barcode Reader, Barcode Event, Type, Data Attached (Unencrypted Data)
FC
var
Barcode Data Container
T
R
/DF74
var
Barcode Data
B
O
VAS Error Report
FC
var
VAS Error Container
T
R
/DFDF25
var
Device Serial Number (IFD Serial Number)
B
R
/DF75
var
VAS Error Report —
Byte 1 = SW1 returned by the Apple or Android device;
Byte 2 = SW2 returned by the Apple or Android device;
Byte 3 = Slot Number;
Byte 4 = Where in the VAS command sequence the error occurred:
0x00 = Select OSE Error;
0x01 = Get VAS Data Error (Apple only);
0x02 = Select Smart Tap Error (Google only);
0x03 = Negotiate Secure Session Error (Google only);
0x04 = Get Select Smart Tap Error (Google only).
B
R
Notification Example - VAS Error Report - A
Notification Example - VAS Error Report - B
Last updated

