> 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/sdks-and-tools/~/revisions/7gQMuwvu8JKvxaHJDCR8/universal-sdk-documentation/.net-windows/introduction.md).

# Introduction

This document provides instructions for software developers who want to create .NET software solutions that include MagTek devices connected to a Windows based host. MagTek Universal SDK (MTUSDKNET) incorporates MagTek SCRA and MagTek PIN Pad SCRA devices into one SDK. This document is part of a larger library of documents designed to assist MagTek device implementers.

The following documents are essential:

* <mark style="color:red;">**DynaFlex Products Programmer’s Manual**</mark>&#x20;
* <mark style="color:red;">**DynaFlex Family of Products Installation and Operation Manual**</mark>

### About the MagTek Sample Code <a href="#id-1.1_about_the_magtek_sample_code" id="id-1.1_about_the_magtek_sample_code"></a>

The sample code provides C# demonstration source code and a reusable MTUSDKNET API library that provides developers of custom software solutions with an easy-to-use interface for MagTek devices.

Developers can distribute the MTUSDKNET API Library to customers or distribute internally as part of an enterprise solution.

### Nomenclature <a href="#id-1.2_nomenclature" id="id-1.2_nomenclature"></a>

* Device refers to the MagTek devices that receives and responds to command set.
* Host refers to the piece of general-purpose electronic equipment the device is connected or paired to, which sends data to and receives data from the device. Host types include but not limited to PC and Mac computers, tablets, and smartphones. When “host” must be used differently, it is qualified as something specific, such as “USB host.”
* User in this document generally refers to the cardholder.

### SDK Contents <a href="#id-1.3_sdk_contents" id="id-1.3_sdk_contents"></a>

<table data-header-hidden><thead><tr><th width="179.33331298828125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">File name</td><td valign="top">Description</td></tr><tr><td valign="top">MTUSDKDemo.exe</td><td valign="top">Visual Studio built sample executable.</td></tr><tr><td valign="top">MTUSDKNET.dll</td><td valign="top">This is a Microsoft .NET DLL to implement MagTek device functions.</td></tr></tbody></table>

#### System Requirements <a href="#id-1.3.1_system_requirements" id="id-1.3.1_system_requirements"></a>

Operating systems:

* Windows 8.1
* Windows 10
* Windows 11
* Microsoft .NET Standard 4.6.1 and above.
* Bluetooth LE requires Windows 8.1 or higher.
* 802.11 Wireless requires Windows 7 or higher.

### TLS Trust and WebSocket WSS connection:

* Root Certificate, Sub CA Certificate, and Client private key Certificate as referenced in document <mark style="color:red;">**DynaFlex II PED Using Wireless LAN Guide**</mark>. The client private key certificate (client.p12) must be accessible to the custom software that makes a secure WebSocket connection to the DynaFlex II PED.


---

# 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/sdks-and-tools/~/revisions/7gQMuwvu8JKvxaHJDCR8/universal-sdk-documentation/.net-windows/introduction.md?ask=<question>&goal=<user_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.
