> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/notifications/0x01nn-transactions/0x0101-transaction-information-update.md). # 0x0101 - Transaction Information Update This notification reports information about progress and state changes that occur during a transaction. For this notification, Notification Detail described in [**Notification Message**](https://developer.magtek.com/api-and-command-reference/preliminary-documentation-scra-dynafamily-programmers-manual/preliminary-documentation-message-format-and-structure/preliminary-documentation-message-structure#notification-message-format) contains one byte each, shown in [**Notification Detail Codes**](https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/notifications/0x18nn-from-user-interface/0x1805-user-interface-operation-complete#notification-detail-codes-0x1805), 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 - 0x07 {% hint style="info" %} 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. {% endhint %}

PT	Rsn	Det	Ext	Meaning
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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached in the Notification Payload portion of the Notification Message (MCE Only).

### Notification Detail Codes - 0x08 {% hint style="info" %} 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 {% endhint %}

PT	Rsn	Det	Ext	Meaning
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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached in the Notification Payload portion of the Notification Message (MSR Only).

### Notification Detail Codes - 0x10 {% hint style="info" %} 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 {% endhint %}

PT	Rsn	Det	Ext	Meaning
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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 ification Payload for Data Update, ARQC Update (Quick Chip), Data Attached in the Notification Payload portion of the Notification Message (EMV Contact Only).

### Notification Detail Codes - 0x20 {% hint style="info" %} 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 {% endhint %}

PT	Rsn	Det	Ext	Meaning
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 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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip, Data Attached 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 Notification Payload for Data Update, ARQC Update (Quick Chip, Data Attached in the Notification Payload portion of the Notification Message (EMV Contactless Only).

### Notification Detail Codes - 0x30 {% hint style="info" %} Payment Technology 0x30 Barcode Reader contains transaction notification detail codes involving barcodes (BCR Only). Reason: 0x01 = Barcode Event. {% endhint %}

PT	Rsn	Det	Ext	Meaning
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 Notification Payload for Data Update Barcode Event, Type (Encrypted Data Attached). Data that is not encrypted is in the format described in Notification Payload for Data Update, Barcode Event, Type, Data Attached (Unencrypted Data) (BCR Only) Barcode Reader, Barcode Event, MagTek Blob Type, Data Attached In this case, the device includes additional data, defined in Notification Payload for Data Update, ARQC Update (Quick Chip, Data Attached, in the Notification Payload portion of the Notification Message

Rsn

Det

Ext

Meaning

(BCR Only) Barcode Reader, Barcode Event, Read, Reserved

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 Notification Payload for Data Update Barcode Event, Type (Encrypted Data Attached). Data that is not encrypted is in the format described in Notification Payload for Data Update, Barcode Event, Type, Data Attached (Unencrypted Data)

(BCR Only)

Barcode Reader, Barcode Event, MagTek Blob Type, Data Attached

In this case, the device includes additional data, defined in Notification Payload for Data Update, ARQC Update (Quick Chip, Data Attached, in the Notification Payload portion of the Notification Message

### Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached

Tag	Len	Value / Description	Typ	Req
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)

Tag	Len	Value / Description	Typ	Req
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 Notification Payload for Data Update, Barcode Event, Type, Data Attached (Unencrypted Data).	B	R
/DFDF50	var	Encrypted Data KSN	B	R
/DFDF51	01	Encrypted Data Encryption Type — See 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)

Tag	Len	Value / Description	Typ	Req	Default
FC	var	Barcode Data Container	T	R
/DF74	var	Barcode Data	B	O

### VAS Error Report

Tag	Len	Value / Description	Typ	Req
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

Tag

Len

Value / Description

Typ

Req

Default

var

VAS Error Container

/DFDF25

var

Device Serial Number (IFD Serial Number)

/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).

#### Notification Example {% code title="Example (hex)" %} ``` AA 00 81 04 83 00 01 01 82 04 10 08 02 02 84 82 01 F8 01 01 84 82 01 F2 01 E9 F9 82 01 E5 DF DF 54 0A 00 00 00 00 00 00 00 00 00 00 DF DF 55 01 82 DF DF 25 0F 42 34 44 42 38 31 37 31 31 31 39 31 39 41 41 FA 82 01 BB 70 82 01 B7 DF DF 53 01 00 5F 20 12 47 55 53 54 49 4E 2F 53 54 45 50 48 41 4E 49 45 20 4D 5F 30 02 02 01 DF DF 4D 25 3B 35 33 32 32 30 30 30 30 36 30 30 30 31 36 37 34 3D 31 38 30 39 32 30 31 30 30 30 30 30 30 30 30 30 30 30 3F DF DF 52 01 05 F8 82 01 66 DF DF 59 82 01 48 36 69 98 57 4C 81 08 66 28 B6 1F DD 69 B1 C3 43 F7 BA 98 B2 5A 92 53 5F DA 63 6D DA 44 95 F1 15 2D 01 07 9A 4C EB 28 0B 30 5C 21 B2 39 ED E7 EE B6 1A 79 43 56 2E 26 1E C9 87 86 19 68 FA EB 4A 2B BD F5 5D 54 6F C4 67 97 FF 42 2C D6 CF 36 03 48 58 A4 23 9B 51 03 5C 32 0B DC 5E 4E E5 95 1B B5 C5 18 E7 33 0B D2 FE 8D E8 5C 47 4D 3C 16 79 42 48 1D CD 83 D5 58 64 48 23 17 F3 29 A7 F1 F1 75 F4 B9 C6 45 F3 02 28 1C 90 C7 83 B9 49 AF 56 BD 76 73 E7 45 7D 25 C5 77 3F C7 9A 1B ED 52 0A 05 54 15 B7 9A 2A 59 C1 67 6D E2 8C 02 8B 97 64 96 5D 4C F8 31 A2 20 75 12 8D 99 C1 A2 DF AB 55 0A 62 24 79 CF A8 51 3D AE 84 91 A5 80 19 9F BC 75 B0 F9 56 5E BA 57 A3 B1 61 AA 84 43 F0 D8 E6 44 C1 FA 51 0E 0A B0 F7 F2 61 57 5B 86 7E AB DC 49 00 87 A0 3B 69 5F C1 45 C4 10 9A A8 5F B6 30 59 2C 25 FA 15 A5 44 83 24 96 3D 5A 03 50 36 02 EC 6B 15 7C 8D CC 66 BF B7 F4 CF 4C 6D 67 75 87 B9 4E D4 08 76 25 F8 B8 EF BF A8 A0 72 F9 81 AB FF 49 84 E7 BC 8F C5 DD A0 86 B2 74 DD 59 8A B2 83 5D DD CC 0C 30 01 96 DF DF 56 0A 90 10 01 0B 4D B8 17 00 00 03 DF DF 57 01 80 DF DF 58 01 05 00 00 00 00 00 00 00 ``` {% endcode %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/notifications/0x01nn-transactions/0x0101-transaction-information-update.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.