> 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/7-30-26-draft-version-scra-dynafamily-programmers-manual/7-30-26-draft-version-notifications/7-30-26-draft-version-0x0101-transaction-information-update.md).

# (7/30/26 Draft version) 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 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

{% hint style="info" %}
Payment Technology 0x07 Manual Card Entry (MCE) contains transaction notification detail codes involving manual card entry (MCE Only).&#x20;

Reasons:&#x20;

* 0x01 = Card Event;&#x20;
* 0x08 = Data Update;&#x20;
* 0x10 = State Update.
  {% endhint %}

<table><thead><tr><th width="71.36370849609375" align="right">PT</th><th width="75.3636474609375" align="right">Rsn</th><th width="71.636474609375" align="right">Det</th><th width="70" align="right">Ext</th><th>Meaning</th></tr></thead><tbody><tr><td align="right">0x07</td><td align="right">0x01</td><td align="right">0x01</td><td align="right">0x00</td><td>Manual Card Entry, Card Event, Data Entered, Reserved (MCE Only)</td></tr><tr><td align="right">0x07</td><td align="right">0x08</td><td align="right">0x02</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x07</td><td align="right">0x08</td><td align="right">0x03</td><td align="right">0x02</td><td>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).</td></tr></tbody></table>

### Notification Detail Codes - Magnetic Stripe Reader

{% hint style="info" %}
Payment Technology 0x08 Magnetic Stripe Reader (MSR) contains transaction notification detail codes involving magnetic stripe cards (MSR Only).&#x20;

Reasons:&#x20;

* 0x01 = Card Event;&#x20;
* 0x08 = Data Update;&#x20;
* 0x10 = State Update
  {% endhint %}

<table><thead><tr><th width="67.27276611328125" align="right">PT</th><th width="74.45452880859375" align="right">Rsn</th><th width="73.45458984375" align="right">Det</th><th width="80" align="right">Ext</th><th>Meaning</th></tr></thead><tbody><tr><td align="right">0x08</td><td align="right">0x01</td><td align="right">0x01</td><td align="right">0x00</td><td>MSR, Card Event, Swiped, Reserved (MSR Only)</td></tr><tr><td align="right">0x08</td><td align="right">0x01</td><td align="right">0x02</td><td align="right">0x00</td><td>MSR, Card Event, Inserted, Reserved (MSR Only)</td></tr><tr><td align="right">0x08</td><td align="right">0x01</td><td align="right">0x03</td><td align="right">0x00</td><td>MSR, Card Event, Removed, Reserved (MSR Only)</td></tr><tr><td align="right">0x08</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x00</td><td>MSR, Card Event, Detected, Reserved</td></tr><tr><td align="right">0x08</td><td align="right">0x08</td><td align="right">0x02</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x08</td><td align="right">0x08</td><td align="right">0x03</td><td align="right">0x02</td><td>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).</td></tr></tbody></table>

### Notification Detail Codes - EMV Contact

{% hint style="info" %}
Payment Technology 0x10 EMV Contact contains transaction notification detail codes involving contact chip cards (EMV Contact Only).&#x20;

Reasons:&#x20;

* 0x01 = Card Event;&#x20;
* 0x02 = Online PIN Event;&#x20;
* 0x08 = Data Update;&#x20;
* 0x10 = State Update
  {% endhint %}

<table><thead><tr><th width="66.63641357421875" align="right">PT</th><th width="74.5455322265625" align="right">Rsn</th><th width="74.45458984375" align="right">Det</th><th width="71.727294921875" align="right">Ext</th><th>Meaning</th></tr></thead><tbody><tr><td align="right">0x10</td><td align="right">0x01</td><td align="right">0x02</td><td align="right">0x00</td><td>EMV Contact, Card Event, Inserted, Reserved (EMV Contact Only)</td></tr><tr><td align="right">0x10</td><td align="right">0x01</td><td align="right">0x03</td><td align="right">0x00</td><td>EMV Contact, Card Event, Removed, Reserved (EMV Contact Only)</td></tr><tr><td align="right">0x10</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x00</td><td>EMV Contact, Card Event, Detected, Reserved (EMV Contact Only)</td></tr><tr><td align="right">0x10</td><td align="right">0x02</td><td align="right">0x06</td><td align="right">0x01</td><td>EMV Contact, Online PIN Event, PIN Entry, PIN Pad Error (EMV Contact Only)</td></tr><tr><td align="right">0x10</td><td align="right">0x02</td><td align="right">0x06</td><td align="right">0x02</td><td>EMV Contact, Online PIN Event, PIN Entry, PIN Block Encryption Error (EMV Contact Only)</td></tr><tr><td align="right">0x10</td><td align="right">0x08</td><td align="right">0x02</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x10</td><td align="right">0x08</td><td align="right">0x03</td><td align="right">0x02</td><td>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).</td></tr></tbody></table>

### Notification Detail Codes - EMV Contactless

{% hint style="info" %}
Payment Technology 0x20 EMV Contactless contains transaction notification detail codes involving contactless cards and contactless payment devices.&#x20;

Reasons:&#x20;

* 0x01 = Card Event;&#x20;
* 0x02 = Online PIN Event;&#x20;
* 0x08 = Data Update;&#x20;
* 0x10 = State Update
  {% endhint %}

<table><thead><tr><th width="71.0909423828125" align="right">PT</th><th width="77.18182373046875" align="right">Rsn</th><th width="74.272705078125" align="right">Det</th><th width="71.6363525390625" align="right">Ext</th><th>Meaning</th></tr></thead><tbody><tr><td align="right">0x00</td><td align="right">0x10</td><td align="right">0x01</td><td align="right">0x00</td><td>None, State Update, Transaction Started by Device, Legacy EMV Flow (Touch Only)</td></tr><tr><td align="right">0x00</td><td align="right">0x10</td><td align="right">0x01</td><td align="right">0x01</td><td>None, State Update, Transaction Started by Device, Quick Chip Flow (Touch Only)</td></tr><tr><td align="right">0x00</td><td align="right">0x10</td><td align="right">0x02</td><td align="right">0x00</td><td>None, State Update, Transaction Canceled, Reserved (Touch Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x03</td><td align="right">0x00</td><td>EMV Contactless, Card Event, Removed, Reserved (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x00</td><td>EMV Contactless, Card Event, Detected, EMV (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x01</td><td>EMV Contactless, Card Event, Detected, NFC/MIFARE Ultralight (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x02</td><td>EMV Contactless, Card Event, Detected, MIFARE Classic 1K (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x03</td><td>EMV Contactless, Card Event, Detected, MIFARE Classic 4K (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x04</td><td>EMV Contactless, Card Event, Detected, MIFARE DESFire Light (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x05</td><td>EMV Contactless, Card Event, Detected, MIFARE MINI® (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x06</td><td>EMV Contactless, Card Event, Detected, MIFARE Plus EV1 (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x07</td><td>EMV Contactless, Card Event, Detected, MIFARE Plus EV2 (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x08</td><td>EMV Contactless, Card Event, Detected, MIFARE Plus SE (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x09</td><td>EMV Contactless, Card Event, Detected, MIFARE Plus X (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x0A</td><td>EMV Contactless, Card Event, Detected, MIFARE DESFire EV1 (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x0B</td><td>EMV Contactless, Card Event, Detected, MIFARE DESFire EV2 (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x04</td><td align="right">0x0C</td><td>EMV Contactless, Card Event, Detected, MIFARE DESFire EV3 (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x05</td><td align="right">0x00</td><td>EMV Contactless, Card Event, Collision, Reserved (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x10</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x01</td><td align="right">0x20</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x02</td><td align="right">0x06</td><td align="right">0x01</td><td>EMV Contactless, Online PIN Event, PIN Entry, PIN Pad Error (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x02</td><td align="right">0x06</td><td align="right">0x02</td><td>EMV Contactless, Online PIN Event, PIN Block Encryption Error (EMV Contactless Only)</td></tr><tr><td align="right">0x20</td><td align="right">0x08</td><td align="right">0x02</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x08</td><td align="right">0x03</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x08</td><td align="right">0x04</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x08</td><td align="right">0x07</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right">0x20</td><td align="right">0x08</td><td align="right">0x08</td><td align="right">0x02</td><td>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).</td></tr><tr><td align="right"></td><td align="right"></td><td align="right"></td><td align="right"></td><td></td></tr></tbody></table>

### Notification Detail Codes - Barcode Reader

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

<table><thead><tr><th width="72.81817626953125" align="right">PT</th><th width="76.272705078125" align="right">Rsn</th><th width="77.9090576171875" align="right">Det</th><th width="70.6363525390625" align="right">Ext</th><th>Meaning</th></tr></thead><tbody><tr><td align="right">30</td><td align="right">01</td><td align="right">01</td><td align="right">00</td><td>(BCR Only) Barcode Reader, Barcode Event, Read, Reserved</td></tr><tr><td align="right">30</td><td align="right">08</td><td align="right">00</td><td align="right">02</td><td><p>Barcode Reader, Barcode Update, Type, Data Attached</p><ul><li>Type 0x00 = Unknown</li><li>Type 0x01 = MagTek</li><li>Type 0x02 = EMV</li></ul><p></p><p>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</p><p>(BCR Only)</p><p></p><p>Barcode Reader, Barcode Event, MagTek Blob Type, Data Attached</p><p></p><p>In this case, the device includes additional data, defined in Table 7.1‑2, in the Notification Payload portion of the Notification Message</p></td></tr></tbody></table>

### Notification Detail Codes - mDOC

{% hint style="info" %}
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
{% endhint %}

<table data-header-hidden><thead><tr><th width="51"></th><th width="55"></th><th width="62"></th><th width="62"></th><th></th></tr></thead><tbody><tr><td>PT</td><td>Rsn</td><td>Det</td><td>Ext</td><td>Meaning</td></tr><tr><td>40</td><td>01</td><td>01</td><td>00</td><td>mDoc, Engagement Event, QR Code, Reserved</td></tr><tr><td>40</td><td>01</td><td>02</td><td>00</td><td>mDoc, Engagement Event, NFC, Reserved</td></tr><tr><td>40</td><td>08</td><td>01</td><td>02</td><td><p>mDoc, Data Retrieval, Type, Data Attached</p><p>·         Type 0x01 = SessionData</p><p>·         Type 0x02 = SessionData Failure</p></td></tr><tr><td>40</td><td>09</td><td>01</td><td>01</td><td>mDoc, Subscription, Expiration, Warning</td></tr><tr><td>40</td><td>09</td><td>01</td><td>02</td><td>mDoc, Subscription, Expiration, Expired</td></tr></tbody></table>

### mDOC Encrypted Notification - mDL/mPass

<table data-header-hidden><thead><tr><th></th><th width="57"></th><th></th><th width="56"></th><th width="58"></th><th width="83"></th></tr></thead><tbody><tr><td>Tag</td><td>Len</td><td>Value / Description</td><td>Typ</td><td>Req</td><td>Default</td></tr><tr><td>2-byte MSB message length excluding padding and CBC-MAC</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>F9</td><td>var</td><td>Container for MAC structure and generic data</td><td>T</td><td>R</td><td> </td></tr><tr><td>/DFDF54</td><td>var</td><td>MAC KSN</td><td>B</td><td>R</td><td> </td></tr><tr><td>/DFDF55</td><td>01</td><td>MAC Encryption Type</td><td>B</td><td>R</td><td> </td></tr><tr><td>/F8</td><td>var</td><td>Container for Encrypted Data</td><td>T</td><td>R</td><td> </td></tr><tr><td>//DFDF59</td><td>var</td><td><p>Encrypted Data Primitive</p><p>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. </p></td><td>B</td><td>R</td><td> </td></tr><tr><td>//DFDF56</td><td>var</td><td>Encrypted Data KSN</td><td>B</td><td>R</td><td> </td></tr><tr><td>//DFDF57</td><td>01</td><td>Encrypted Data Encryption Type</td><td>B</td><td>R</td><td> </td></tr><tr><td>//DFDF58</td><td>01</td><td><p>Number of Padding Bytes</p><p>Number of bytes added to DFDF59 value to force its length to a multiple of 16 bytes for AES.</p></td><td>B</td><td>R</td><td> </td></tr><tr><td>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.</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>Four-byte CMAC.  The host should calculate the CMAC and verify that it matches. </td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

### mDL DFDF59 Decrypted Contents

<table data-header-hidden><thead><tr><th></th><th width="57"></th><th></th><th width="55"></th><th width="54"></th><th width="81"></th></tr></thead><tbody><tr><td>Tag</td><td>Len</td><td>Value / Description</td><td>Typ</td><td>Req</td><td>Default</td></tr><tr><td>FF43</td><td>var</td><td><p>Decrypted/Raw Data Container</p><p>Inside this container, the device inserts TLV data objects of response data of various nameSpaces defines in ISO-18013 and ISO-23220.</p></td><td>T</td><td>R</td><td> </td></tr><tr><td><p>/DFB001 to</p><p>/DFB04</p></td><td>var</td><td>Response data of nameSpace “org.iso.18013.5.1”.</td><td>B</td><td>O</td><td> </td></tr><tr><td><p>/DFB041 to</p><p>/DFB060</p></td><td>var</td><td>Response data of nameSpace “org.iso.18013.5.1.aamva”.</td><td>B</td><td>O</td><td> </td></tr><tr><td><p>/DFB061 to</p><p>/DFB07F</p></td><td>var</td><td>Response data of nameSpace “org.iso.23220.1”.</td><td>B</td><td>O</td><td> </td></tr><tr><td>Padding to force DFDF59 plus padding to be a multiple of 8 (for TDES) or 16 (for AES) bytes for encryption.</td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

#### Response. Command has started running:

{% code overflow="wrap" %}

```
AA-00
81-04-82-05-12-01   // Response of Command 0x1201
82-04-01-00-00-00   // Started
```

{% endcode %}

#### Notification 0x0101          (Engagement event with QR Code)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01   // Notification 0x0101
82 04 40 01 01 00   // Event: Engagement with QR Code
```

{% endcode %}

#### Notification 0x0101          (Engagement event with NFC)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01   // Notification 0x0101
82 04 40 01 02 00   // Event: Engagement with NFC
```

{% endcode %}

#### 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**

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01
82 04 40 08 01 02
84 82 00 6A 01 01                       // 0x006A, LN7=LN6 + 6
84 82 00 64                             // 0x0064, LN6=LN5 + 2 + 5(Padding) + 4(CKSUM)
00 59                                   // 0x0059, LN5=LN4 + 4
F9 82 00 55                             // 0x0055, LN4=LN3 + 25 (23 for TDES MAC)
DF DF 54 0A FFFF987654321020001B        // MAC KSN, 10 bytes for TDES
DF DF 55 01 82                          // MAC Algorithm Type
F8 82 00 3E                             // 0x003E, LN3=LN2 + 6(Len) + 26(56+57+58)(24 for TDES ENC) = 62
DF DF 59 82 00 20                       // 0x0020, LN2=LN1 + 4(Len) + 7(ENC Padding)
43B582C4ED23B5631A0E8F5FB06F1612        // LN1=0x20 – 4(Len) – 7(ENC Padding) = 21
761672430C5C363D2A98660827AA345E
DF DF 56 0A FFFF987654321020001A        // Encryption KSN, 10 bytes for TDES
DF DF 57 01 80                          // Encryption Algorithm Type
DF DF 58 01 07                          // Padding count for Encryption, 7 bytes
05 05 05 05 05                          // PKCS7 padding bytes for MACing, 5 bytes
3B AE 3A 8B                             // MAC checksum, 4 bytes
```

{% endcode %}

**Case #2: Both Encryption and MACing are using AES key**

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01
82 04 40 08 01 02
84 82 00 6A 01 01                       // 0x006A, LN7=LN6 + 6
84 82 00 64                             // 0x0064, LN6=LN5 + 2 + 1(Padding) + 4(CKSUM)
00 5D                                   // 0x005D, LN5=LN4 + 4
F9 82 00 59                             // 0x0059, LN4=LN3 + 25 = 89
DF DF 54 0C 123456789012345600000002    // MAC KSN, 12 bytes for AES
DF DF 55 01 9A                          // MAC Algorithm Type
F8 82 00 40                             // 0x0040, LN3=LN2 + 6(Len) + 26(56+57+58) = 64
DF DF 59 82 00 20                       // 0x0020, LN2=LN1 + 4(Len) + 7(ENC Padding)
C68F6CE9A4793966B82B06FA918A5CF2        // LN1=0x20 – 4(Len) – 7(ENC Padding) = 21
6289664054265992C4C5E021495186C0
DF DF 56 0C 123456789012345600000001    // Encryption KSN, 12 bytes for AES
DF DF 57 01 9D                          // Encryption Algorithm Type
DF DF 58 01 07                          // Padding for encryption, 7 bytes
01                                      // Padding for MACing, 1 byte
6A 4A 24 AE                             // MAC checksum
```

{% endcode %}

#### Decrypted Data:

{% code overflow="wrap" %}

```
FF 43 82 00 17                         // Data Conatiner, 23 bytes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     
DF B0 01 82 00 04                      // Tag 0xDFB001, “family_name”, 4 bytes  
43 48 4F 55  
DF B0 02 82 00 07                      // Tag 0xDFB002, “given_name”, 7 bytes  
57 45 49 2D 54 41 49  
04 04 04 04                            // 4 bytes of PKCS7 padding  
```

{% endcode %}

#### Notification 0x0101, Tagged Data attached, Security is disabled (for both QR Code and NFC modes)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01                       // Notification 0x0101
82 04 40 08 01 02                       // mDoc data attached (SessionData)
84 82 00 1F 01 01                       // Notification Payload, 31 bytes
84 82 00 19                             // Payload, 25 bytes
FD 82 00 15                             // Data Conatiner, 21 bytes
9F 01 82 00 04                          // Tag 0x9F01, “family_name”, 4 bytes
43 48 4F 55
9F 02 82 00 07                          // Tag 0x9F02, “given_name”, 7 bytes
57 45 49 2D 54 41 49 
```

{% endcode %}

#### Notification 0x0101, SessionData failure has been detected (for both QR Code and NFC modes)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 01                        // Notification 0x0101
82 04 40 08 02 02                        // Event: SessionData Failure occurred 
```

{% endcode %}

#### Notification 0x0105, Timeout has occurred (for both QR Code and NFC modes)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 05                       // Notification 0x0105
82 04 00 01 00 00
```

{% endcode %}

#### Notification 0x0105, Host Cancel (CMD 0x1008) (for both QR Code and NFC modes)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 05                       // Notification 0x0105
82 04 00 03 01 00
```

{% endcode %}

#### Notification 0x0105, User Cancel (Display ONLY) (for both QR Code and NFC modes)

{% code overflow="wrap" %}

```
AA 00
81 04 83 00 01 05                       // Notification 0x0105
82 04 00 03 02 00
```

{% endcode %}

### Notification Payload for mDoc Subscription Warning

#### **Level 5 Heading:** Notification 0101 = Transaction Information Update

<table data-header-hidden><thead><tr><th></th><th width="59"></th><th></th><th width="55"></th><th width="57"></th><th width="88"></th></tr></thead><tbody><tr><td>Tag</td><td>Len</td><td>Value / Description</td><td>Typ</td><td>Req</td><td>Default</td></tr><tr><td>84</td><td>var</td><td>Notification Payload</td><td> </td><td> </td><td> </td></tr><tr><td>/81</td><td>1</td><td>Configured Warning Days (from OID 1.2.9.1.1.2 Byte 0)</td><td>B</td><td>R</td><td> </td></tr><tr><td>/82</td><td>1</td><td>Calculated Days Remaining Until ValidTo</td><td>B</td><td>R</td><td> </td></tr><tr><td>/83</td><td>8</td><td>Configured ValidTo Epoch time (uint64, little-endian)</td><td>B</td><td>R</td><td> </td></tr></tbody></table>

{% hint style="info" %}
**Example inner payload shape under 84:**

&#x20; 81 01 05 82 01 01 83 08 00 65 5D 6A 00 00 00 00

&#x20; (5 warn days, 1 day remaining, ValidTo = 2026-07-20 00:00:00 UTC)
{% endhint %}

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

<table><thead><tr><th width="149.6363525390625">Tag</th><th width="72.45452880859375" align="right">Len</th><th width="282.1817626953125">Value / Description</th><th width="73" align="right">Typ</th><th width="76.3636474609375" align="right">Req</th><th width="97.0908203125" align="right">Default</th></tr></thead><tbody><tr><td>Beginning of Notification Message</td><td align="right"></td><td></td><td align="right"></td><td align="right"></td><td align="right"></td></tr><tr><td>0101 = DynaPro Format Transaction Data</td><td align="right"></td><td></td><td align="right"></td><td align="right"></td><td align="right"></td></tr><tr><td>84</td><td align="right">var</td><td>Transaction Data</td><td align="right">B</td><td align="right">R</td><td align="right"></td></tr><tr><td>/null</td><td align="right">(v)</td><td><p><strong>EMV ARQC Type</strong> data blob, if the notification is an ARQC Update (Quick Chip) notification. </p><p> </p><p><strong>EMV Batch Data Type</strong> data blob, if the notification is a Batch Data notification.</p><p> </p><p>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.</p><p> </p><p><strong>NFC UID Type</strong> reports the unique ID from the NFC tag (EMV Contactless Only)</p><p> </p><p><strong>GPO Response Type reports the card’s GPO Response (EMV Contactless Only)</strong></p></td><td align="right">B</td><td align="right">O</td><td align="right"></td></tr><tr><td>End of Notification Message</td><td align="right"></td><td></td><td align="right"></td><td align="right"></td><td align="right"></td></tr></tbody></table>

### Notification Payload for Barcode Reader, Barcode Event, Type (Encrypted Data Attached)

<table><thead><tr><th width="162.3636474609375">Tag</th><th width="75.18182373046875" align="right">Len</th><th width="294.9090576171875" align="right">Value / Description</th><th width="74" align="right">Typ</th><th width="74.54541015625" align="right">Req</th><th width="96.181884765625">Default</th></tr></thead><tbody><tr><td>Beginning of Notification Message</td><td align="right"></td><td align="right"></td><td align="right"></td><td align="right"></td><td></td></tr><tr><td>1805 = User Interface Operation Complete</td><td align="right"></td><td align="right"></td><td align="right"></td><td align="right"></td><td></td></tr><tr><td>84</td><td align="right">var</td><td align="right">Notification Payload</td><td align="right">B</td><td align="right">R</td><td></td></tr><tr><td>/DFDF59</td><td align="right">var</td><td align="right"><p>Encrypted Data Primitive</p><p>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.</p></td><td align="right">B</td><td align="right">R</td><td></td></tr><tr><td>/DFDF50</td><td align="right">var</td><td align="right">Encrypted Data KSN</td><td align="right">B</td><td align="right">R</td><td></td></tr><tr><td>/DFDF51</td><td align="right">01</td><td align="right">Encrypted Data Encryption Type — See section 4.4 Encryption Type for a list of valid values.</td><td align="right">B</td><td align="right">R</td><td></td></tr><tr><td>End of Notification Message</td><td align="right"></td><td align="right"></td><td align="right"></td><td align="right"></td><td></td></tr></tbody></table>

### Notification Payload for Barcode Reader, Barcode Event, Type, Data Attached (Unencrypted Data)

<table><thead><tr><th width="78.3636474609375">Tag</th><th width="72.272705078125" align="right">Len</th><th>Value / Description</th><th width="77.54541015625" align="right">Typ</th><th width="75.45458984375" align="right">Req</th><th width="98">Default</th></tr></thead><tbody><tr><td>FC</td><td align="right">var</td><td>Barcode Data Container</td><td align="right">T</td><td align="right">R</td><td></td></tr><tr><td>/DF74</td><td align="right">var</td><td>Barcode Data</td><td align="right">B</td><td align="right">O</td><td></td></tr></tbody></table>

### VAS Error Report

<table><thead><tr><th width="99.1817626953125">Tag</th><th width="74.09088134765625" align="right">Len</th><th width="358.5455322265625">Value / Description</th><th width="74.8182373046875" align="right">Typ</th><th width="77.272705078125" align="right">Req</th><th width="98">Default</th></tr></thead><tbody><tr><td>FC</td><td align="right">var</td><td>VAS Error Container</td><td align="right">T</td><td align="right">R</td><td></td></tr><tr><td>/DFDF25</td><td align="right">var</td><td>Device Serial Number (IFD Serial Number)</td><td align="right">B</td><td align="right">R</td><td></td></tr><tr><td>/DF75</td><td align="right">var</td><td><p>VAS Error Report — </p><p></p><ul><li>Byte 1 = SW1 returned by the Apple or Android device;</li><li>Byte 2 = SW2 returned by the Apple or Android device;</li><li>Byte 3 = Slot Number; </li><li>Byte 4 = Where in the VAS command sequence the error occurred: </li></ul><p></p><ul><li>0x00 = Select OSE Error; </li><li>0x01 = Get VAS Data Error (Apple only); </li><li>0x02 = Select Smart Tap Error (Google only); </li><li>0x03 = Negotiate Secure Session Error (Google only); </li><li>0x04 = Get Select Smart Tap Error (Google only).</li></ul></td><td align="right">B</td><td align="right">R</td><td></td></tr></tbody></table>

### Notification Example - VAS Error Report - A

{% 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 %}

### Notification Example - VAS Error Report - B

{% code title="Example (hex)" %}

```
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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/api-and-command-reference/7-30-26-draft-version-scra-dynafamily-programmers-manual/7-30-26-draft-version-notifications/7-30-26-draft-version-0x0101-transaction-information-update.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
