> 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/scra-dynafamily-programmers-manual/notifications.md).

# Notifications

## Notifications

Transaction notifications are the asynchronous messages a Dyna-family reader sends while a transaction is running, reporting progress, state changes, and completion. Use the table below to jump to a specific notification.

{% hint style="success" %}
Applies to: All Dyna Family products
{% endhint %}

### Notifications Categories

{% hint style="info" %}
**Click category to go specific commands**
{% endhint %}

| **Notification Group**                                                                                                                                                                                                | **When it fires**                                                                                                       |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**0x01nn - Transactions**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x01nn-transactions)                           | During a transaction.                                                                                                   |
| [<mark style="color:red;">**0x02nn - Banking Functions**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x02nn-banking-functions)                 | On progress and when states changes during interaction with the Banking Functions modules.                              |
| [<mark style="color:red;">**0x03nn - Generic Pass-Through Mode**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x03nn-generic-pass-through-mode) | On progress and when states changes during a Pass-Through Mode.                                                         |
| [<mark style="color:red;">**0x09nn - Firmware Updates**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x09nn-firmware-updates)                   | When checking on or reporting the status of a firmware update.                                                          |
| [<mark style="color:red;">**0x10nn - From Device**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x10nn-from-device)                             | During general state changes that occur within the device, outside the context of specific operations like transactions |
| [<mark style="color:red;">**0x18nn - From User Interface**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications#id-0x18nn-from-user-interface)             | During operations involving the User Interface                                                                          |

### 0x01nn - Transactions

| **Notification Group**                                                                                                                                                                                                                             | **When it fires**                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [<mark style="color:red;">**0x0101 - Transaction Information Update**</mark> ](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x01nn-transactions/0x0101-transaction-information-update)  | During a transaction.            |
| [<mark style="color:red;">**0x0105 - Transaction Operation Complete​**</mark> ](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x01nn-transactions/0x0105-transaction-operation-complete) | Upon completion of a transaction |

### 0x02nn - Banking Functions

| **Notification Group**                                                                                                                                                                                                                                            | **When it fires**                                                                                                                        |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**0x0201 - Banking Functions Information Update**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x02nn-banking-functions/0x0201-banking-functions-information-update) | This notification reports information about progress and state changes involving the device’s Banking Functions modules.                 |
| [<mark style="color:red;">**0x0205 - Banking Functions Operation Complete**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x02nn-banking-functions/0x0205-banking-functions-operation-complete) | This notification reports information about progress and state changes that occur during interaction with the Banking Functions modules. |

### 0x03nn - Generic Pass-through Mode

| **Notification Group**                                                                                                                                                                                                                                                    | **When it fires**                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**0x0301 - Pass-Through Mode Information Update**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x03nn-generic-pass-through-mode/0x0301-pass-through-mode-information-update) | This notification reports information about progress and state changes that occur during a Pass-Through Mode. |

### 0x09nn - Firmware Updates

| **Notification Group**                                                                                                                                                                                                                        | **When it fires**                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**0x0905 - Firmware Updates Successful**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x09nn-firmware-updates/0x0905-firmware-update-successful) | This notification reports the successful completion of firmware update operations the host initiated using Load Firmware File and Commit Firmware from File |
| [<mark style="color:red;">**0x0906 - Firmware Update Failed**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x09nn-firmware-updates/0x0906-firmware-update-failed)          | This notification reports the failure of a Firmware Update command the host initiated using Load Firmware File and Commit Firmware from File.               |
| [<mark style="color:red;">**0x0907 - Firmware is Up to Date**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x09nn-firmware-updates/0x0907-firmware-is-up-to-date)          | This notification reports Firmware is up to date for host initiated Load Firmware File.                                                                     |

### 0x10nn - From Device

| **Notification Group**                                                                                                                                                                                                                | **When it fires**                                                                                      |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| [<mark style="color:red;">**0x1001 - Device Information Update**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x10nn-from-device/0x1001-device-information-update) | This notification reports information about general state changes that occur within the device.        |
| [<mark style="color:red;">**0x1001 - Low Battery Warning**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x10nn-from-device/0x1001-low-battery-warning)             | The device sends this notification when the battery charge reaches 15 percent.                         |
| [<mark style="color:red;">**0x1001 - Low Battery Shutdown**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x10nn-from-device/0x1001-low-battery-shutdown)           | The device sends this notification one minute before it automatically powers down the device.          |
| [<mark style="color:red;">**0x1001 - Battery Charged**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x10nn-from-device/0x1001-battery-charged)                     | The device sends this notification when the battery charger detects that the battery is fully charged. |

### 0x18nn - From User interface

| **Notification Group**                                                                                                                                                                                                                                          | **When it fires**                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**0x1803 - User Interface Host Action Request**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x18nn-from-user-interface/0x1803-user-interface-host-action-request) | Requests that the host take action during operations involving the device’s User Interface modules. |
| [<mark style="color:red;">**0x1805 - User Interface Operation Complete**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/notifications/0x18nn-from-user-interface/0x1805-user-interface-operation-complete)   | Requests that the host take action during operations involving the device’s User Interface modules. |

### Need More Help

{% hint style="info" %}
**Need Help?**

For additional support, please contact MagTek Support:

**Technical Support:**

* 📧 **Email:** [support@magtek.com](mailto:support@magtek.com?subject=Support%20Request)
* 📞 **Phone:** 1-562-546-6800 (US)
* 🕐 **Hours:** Monday-Friday, 5:30 AM - 5:00 PM PST

**Online Resources:**

* 🌐 **Support Portal:** developer.magtek.com

**Documentation Feedback:**

Help us improve this documentation! [feedback@magtek.com](mailto:feedback@magtek.com?subject=Feedback)
{% endhint %}


---

# 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/scra-dynafamily-programmers-manual/notifications.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.