This document provides instructions for software developers who want to create Android software solutions that include MagTek devices connected to an Android based host. MagTek Universal SDK (MTUSDK) 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, which includes the following documents available from MagTek:
The sample code provides Android demonstration source code and a reusable MTUSDK API library that provides developers of custom software solutions with an easy-to-use interface for MagTek devices.
Developers can distribute the MTUSDK API Library to customers or distribute internally as part of an enterprise solution.
Nomenclature
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
File name
Description
MTUSDKDemo.apk
Sample code APK file.
MTUSDK.aar
Universal SDK Android AAR Library file.
System Requirements
Tested operating systems:
Android 4.4.2 and above
Android Studio 3.5.3 and above
Certificate Requirements
When connecting to the DynaFlex II PED device by WLAN, a client certificate and its certificate chain must be installed on the Android device. Root Certificate, Sub CA Certificate, and Client private key Certificate as referenced in document D998200550 DynaFlex II PED Using Wireless LAN Guide.
1
Download the certificate chain to the Android device.
2
The navigation paths for the following instructions may very on the Android device.
If not seen, do a search within Settings for the end of the navigation path.
3
Navigate to Settings --> Security --> More security settings --> Encryption & credentials --> Install a certificate
4
Select CA certificate .
5
Confirm any prompts such as Install anyway .
6
Select the rootCA.crt file.
7
Continue to install the subCA by selecting CA certificate .
8
Confirm any prompts such as Install anyway .
9
Select the subCA.crt file.
10
Verify the certificate chain by navigating to Settings --> Security --> More security settings --> Encryption & credentials --> Trusted credentials.
11
Select User .
12
Installation of certificate chain is complete.
Custom software will need the client private key certificate (client.p12) when creating a connection to DynaFlex II PED WLAN. Place the client.p12 into a folder accessible by the custom software.
