Magtek MPPG Services Programming Manual

Type
Programming Manual
MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350
www.magtek.com
SDK - MagneFlex Powder,
Mi
ddleware
PIN PEDs
Programmers Manual ( MagneFlex Powder V2 API
)
June 202
3
Manual Part Number:
D998200582-1
0
REGISTERED TO ISO 9001:2015
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 2
Copyright © 2006 – 2023 MagTek, Inc.
Printed in the United States of America
Information in this publication is subject to change without notice and may contain technical inaccuracies
or graphical discrepancies. Changes or improvements made to this product will be updated in the next
publication release. No part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purpose, without the express written permission of MagTek, Inc.
MagTek® is a registered trademark of MagTek, Inc.
Bluetooth® is a registered trademark of Bluetooth SIG.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation.
All other system names and product names are the property of their respective owners.
Table 0.1 – Revisions
Rev
Number
Date
Notes
10
June 28, 2023
Initial Release. Based from DynaPro and extended to support DynaFlex.
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 3
SOFTWARE LICENSE AGREEMENT
IMPORTANT: YOU SHOULD CAREFULLY READ ALL THE TERMS, CONDITIONS AND
RESTRICTIONS OF THIS LICENSE AGREEMENT BEFORE INSTALLING THE SOFTWARE
PACKAGE. YOUR INSTALLATION OF THE SOFTWARE PACKAGE PRESUMES YOUR
ACCEPTANCE OF THE TERMS, CONDITIONS, AND RESTRICTIONS CONTAINED IN THIS
AGREEMENT. IF YOU DO NOT AGREE WITH THESE TERMS, CONDITIONS, AND
RESTRICTIONS, PROMPTLY RETURN THE SOFTWARE PACKAGE AND ASSOCIATED
DOCUMENTATION TO THE ADDRESS ON THE FRONT PAGE OF THIS DOCUMENT,
ATTENTION: CUSTOMER SUPPORT.
TERMS, CONDITIONS, AND RESTRICTIONS
MagTek, Incorporated (the "Licensor") owns and has the right to distribute the described software and
documentation, collectively referred to as the "Software."
LICENSE: Licensor grants you (the "Licensee") the right to use the Software in conjunction with
MagTek products. LICENSEE MAY NOT COPY, MODIFY, OR TRANSFER THE SOFTWARE IN
WHOLE OR IN PART EXCEPT AS EXPRESSLY PROVIDED IN THIS AGREEMENT. Licensee
may not decompile, disassemble, or in any other manner attempt to reverse engineer the Software.
Licensee shall not tamper with, bypass, or alter any security features of the software or attempt to do so.
TRANSFER: Licensee may not transfer the Software or license to the Software to another party without
the prior written authorization of the Licensor. If Licensee transfers the Software without authorization,
all rights granted under this Agreement are automatically terminated.
COPYRIGHT: The Software is copyrighted. Licensee may not copy the Software except for archival
purposes or to load for execution purposes. All other copies of the Software are in violation of this
Agreement.
TERM: This Agreement is in effect as long as Licensee continues the use of the Software. The Licensor
also reserves the right to terminate this Agreement if Licensee fails to comply with any of the terms,
conditions, or restrictions contained herein. Should Licensor terminate this Agreement due to Licensee's
failure to comply, Licensee agrees to return the Software to Licensor. Receipt of returned Software by
the Licensor shall mark the termination.
LIMITED WARRANTY: Licensor warrants to the Licensee that the disk(s) or other media on which
the Software is recorded are free from defects in material or workmanship under normal use.
THE SOFTWARE IS PROVIDED AS IS. LICENSOR MAKES NO OTHER WARRANTY OF ANY
KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Because of the diversity of conditions and PC hardware under which the Software may be used, Licensor
does not warrant that the Software will meet Licensee specifications or that the operation of the Software
will be uninterrupted or free of errors.
IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES, INCLUDING ANY LOST
PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE, OR INABILITY TO USE, THE SOFTWARE. Licensee's sole remedy in
the event of a defect in material or workmanship is expressly limited to replacement of the Software
disk(s) if applicable.
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 4
GOVERNING LAW: If any provision of this Agreement is found to be unlawful, void, or
unenforceable, that provision shall be removed from consideration under this Agreement and will not
affect the enforceability of any of the remaining provisions. This Agreement shall be governed by the
laws of the State of California and shall inure to the benefit of MagTek, Incorporated, its successors or
assigns.
ACKNOWLEDGMENT: LICENSEE ACKNOWLEDGES THAT HE HAS READ THIS
AGREEMENT, UNDERSTANDS ALL OF ITS TERMS, CONDITIONS, AND RESTRICTIONS, AND
AGREES TO BE BOUND BY THEM. LICENSEE ALSO AGREES THAT THIS AGREEMENT
SUPERSEDES ANY AND ALL VERBAL AND WRITTEN COMMUNICATIONS BETWEEN
LICENSOR AND LICENSEE OR THEIR ASSIGNS RELATING TO THE SUBJECT MATTER OF
THIS AGREEMENT.
QUESTIONS REGARDING THIS AGREEMENT SHOULD BE ADDRESSED IN WRITING TO
MAGTEK, INCORPORATED, ATTENTION: CUSTOMER SUPPORT, AT THE ADDRESS LISTED
IN THIS DOCUMENT, OR E-MAILED TO [email protected].
DEMO SOFTWARE / SAMPLE CODE: Unless otherwise stated, all demo software and sample code
are to be used by Licensee for demonstration purposes only and MAY NOT BE incorporated into any
production or live environment. The PIN Pad sample implementation is for software PIN Pad test
purposes only and is not PCI compliant. To meet PCI compliance in production or live environments, a
third-party PCI compliant component (hardware or software-based) must be used.
0 - Table of Contents
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 5
Table of Contents
SOFTWARE LICENSE AGREEMENT ................................................................................................................. 3
Table of Contents .............................................................................................................................................. 5
1 Introduction ............................................................................................................................................... 7
1.1 About the MagneFlex Powder V2 API ........................................................................................... 7
1.2 Nomenclature ................................................................................................................................... 7
1.3 SDK Contents .................................................................................................................................... 7
1.4 System Requirements ..................................................................................................................... 8
1.5 Interfaces for Operating Systems .................................................................................................. 8
2 How to Set Up the MagneFlex Powder V2 API ..................................................................................... 9
2.1 How to Connect MagneFlex Powder V2 Service to a Host App ................................................. 9
2.2 How to Connect MagneFlex Powder V2 Service to Java jQuery ................................................ 9
2.3 How to Connect DynaPro Mini to a Windows Host via BLE ....................................................... 9
3 MagneFlex Powder V2 Resources DynaFlex devices ..................................................................... 13
3.1 CheckHealth .................................................................................................................................... 13
3.2 DisplayMessageV1 ......................................................................................................................... 13
3.3 EndPINSessionV1 ........................................................................................................................... 16
3.4 ReleaseDeviceV1 ............................................................................................................................ 17
3.5 RequestDeviceListV1 ..................................................................................................................... 18
3.6 RequestManualCardV1 ................................................................................................................. 19
3.7 RequestPINWithPANFromCardV1 ............................................................................................... 23
3.8 RequestPINWithSuppliedPANV1 ................................................................................................. 25
3.9 RequestSendAcquirerResponseV1.............................................................................................. 28
3.10 RequestSendCommandV1 ....................................................................................................... 32
3.11 RequestSignatureV1 .................................................................................................................. 34
3.12 RequestSmartCardV1 ................................................................................................................ 35
3.13 ScanBarCodeV1 .......................................................................................................................... 40
3.14 ShowBarCodeV1 ......................................................................................................................... 42
4 MagneFlex Powder V2 Resources DynaPro devices ...................................................................... 45
4.1 CheckHealth .................................................................................................................................... 45
4.2 ReleaseDevice ................................................................................................................................ 45
4.3 ReleaseDeviceEx ............................................................................................................................ 45
4.4 RequestCardSwipe ......................................................................................................................... 46
4.5 RequestDeviceStatus .................................................................................................................... 51
4.6 RequestEMVTags ............................................................................................................................ 53
4.7 RequestEndEMVSessionV1 ........................................................................................................... 56
4.8 RequestManualSwipe .................................................................................................................... 57
4.9 RequestOperationStatus ............................................................................................................... 63
4.10 RequestPIN ................................................................................................................................. 63
4.11 RequestSendCommand ............................................................................................................ 66
0 - Table of Contents
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 6
4.12 RequestSignature ...................................................................................................................... 69
4.13 RequestSmartCard .................................................................................................................... 71
4.14 RequestSmartCardEx ................................................................................................................ 76
4.15 RequestSendAcquirerResponse .............................................................................................. 83
Appendix A TLV Data Format .................................................................................................................... 87
A.1 ARQC Message Format ................................................................................................................. 87
A.2 ARQC Response (from online processing) ................................................................................. 87
A.3 Transaction Result Message Batch Data Format .................................................................. 88
A.4 DeviceID URI.................................................................................................................................... 89
1 - Introduction
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 7
1 Introduction
This document provides instructions for software developers to create software solutions that include
IPAD, DynaPro, DynaPro Mini, and DynaFlex products. This document is part of a library of documents
which includes the following from MagTek:
D99875585 DYNAPRO PROGRAMMER'S MANUAL ( COMMANDS )
D99875629 DYNAPRO MINI PROGRAMMER'S MANUAL ( COMMANDS )
D99875430 IPAD PROGRAMMER'S MANUAL ( COMMANDS )
D998200383 DYNAFLEX PRODUCTS PROGRAMMER'S MANUAL ( COMMANDS )
1.1 About the MagneFlex Powder V2 API
The MagneFlex Powder V2 API provides a convenient HTTP command application programming
interface to a device connected to a host. An HTTP client makes JSON calls to the host that are mapped
to the device’s low-level command set, as found in the Programmer’s Manual (Commands). The
MagneFlex Powder V2 can be launched as either a Windows Service, or a through a standalone
executable.
The SDK also includes a sample SOAPUI project and Java jQuery html file that demonstrates JSON calls
to the MagneFlex Powder V2. In addition, source code for the standalone executable is provided, if the
developer wishes to integrate the MagneFlex Powder V2 directly into their own code.
fpo
The MagneFlex Powder V2 API is single-threaded. If the service is busy processing a command to the
device, other calls will be rejected.
1.2 Nomenclature
In this document, the nomenclature below are used as follows:
Device refers to the PED device (eg. DynaPro, DynaFlex) that receives and responds to commands.
Host refers to the piece of general-purpose electronic computing equipment the device is connected
or paired to. Host sends data to and receive data from the device via the MagneFlex Powder V2 API.
V1 at the end of a resource name identifies an extention of the API to be used but not limited for a
DynaFlex device.
For example:
RequestSmartCard is for DynaPro devices.
RequestSmartCardV1 is an extention for DynaFlex devices.
User in this document generally refers to the cardholder.
1.3 SDK Contents
Executables:
File
Description
MTUSDK.WEBAPI.Host.exe
MagTek WEBAPI executable
MTUSDK.WEBAPI.Host.exe.config
MagTek WEBAPI executable configuration file
MTUSDK.WEBAPI.HostService.exe
MagTek WEBAPI Windows service
MTUSDK.WEBAPI.HostService.exe.config
MagTek WEBAPI Windows service configuration files
Sample SOAPUI project:
1 - Introduction
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 8
File
Description
MagneFlex Powder Dual Sample-soapui-project.xml
Sample SOAPUI project file
Sample Java web page:
File
Description
Sample.html
Sample Java jQuery html file
tlvdecoder.js
Java TLV decoder
1.4 System Requirements
Tested operating systems:
Windows 7
Windows 8
Windows 8.1
Windows 10
Microsoft .Net Framework 4.5 installed. (The API installation process will install this if it does not
already exist on the host.)
Tested development environments:
Windows 10 with Microsoft Visual Studio 2017
1.5 Interfaces for Operating Systems
The following table matches the device interface to operating system.
Device
Operating System
DynaPro
Windows 7, Windows 8, 8.1 & Windows 10
Windows 7, Windows 8, 8.1 & Windows 10
DynaPro Mini
Windows 7, Windows 8, 8.1 & Windows 10
Windows 8, 8.1 & Windows 10
DynaPro Go
Windows 7, Windows 8, 8.1 & Windows 10
Windows 8, 8.1 & Windows 10
Windows 8, 8.1 & Windows 10
IPAD
Windows 7, Windows 8, 8.1 & Windows 10
DynaFlex
Windows 7, Windows 8, 8.1 & Windows 10
2 - How to Set Up the MagneFlex Powder V2 API
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 9
2 How to Set Up the MagneFlex Powder V2 API
2.1 How to Connect MagneFlex Powder V2 Service to a Host App
To use the MagneFlex Powder (MUSDK.WEBAPI.HostService.exe)
1) In all Request, set the header ContentType to "application/json"
2) Build the JSON object for the MagneFlex Powder V2 resource to be accessed.
3) Send HTTP request methods GET and POST to the base address
http://localhost:9001/api/mtppscrahost/ with the resource endpoint concatenated.
2.2 How to Connect MagneFlex Powder V2 Service to Java jQuery
To use the MagneFlex Powder V2 (MTUSDK.WEBAPI.HostService.exe)
1) In all Request, set the header ContentType to "application/json"
2) Build the JSON object for the MagneFlex Powder V2 resource to be accessed.
3) Send HTTP request methods GET and POST to the base address
http://localhost:9001/api/mtppscrahost/ with the resource endpoint concatenated.
4) Access the Sample.html file in a browser by navigating to http://localhost:9001/sample/Sample.html
5) The Sample.html includes jquery ajax sample code in the <scription> portion of the html body.
6) The Sample.html page demonstrates the functions of the API.
2.3 How to Connect DynaPro Mini to a Windows Host via BLE
To connect DynaPro Mini to a host with Windows 8.1 or higher and Bluetooth 4.0 hardware that supports
BLE, follow these steps:
1) If you are using an external Bluetooth adapter, install any required drivers and connect it to the host.
2) On the host, install and configure the software you intend to use with DynaPro Mini:
a) Make sure the host software is configured to look for the device on the proper connection.
b) Make sure the host software knows which device(s) it should interface with.
c) Make sure the host software is configured to properly interpret incoming data from the device.
This depends on whether the device is configured to transmit data in GATT format or streaming
format emulating a keyboard.
3) Make sure the DynaPro Mini has an adequate charge
4) Unpair from any other host it is already paired with before continuing.
5) Enter app mode, scroll down to Apps by name, and launch the Windows PC Settings app.
2 - How to Set Up the MagneFlex Powder V2 API
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 10
6) In the left side navigator, select PC and devices > Bluetooth.
7) Make sure Bluetooth is turned on and close the PC and devices app.
8) Launch the Windows Manage Bluetooth Devices app by following these steps:
a) Enter desktop mode by swiping in from the left side of the touchscreen.
b) Touch the Bluetooth icon in the system tray and select Add a Bluetooth Device (see Figure
2-1).
Figure 2-1 - Launch Manage Bluetooth Devices App from Desktop Mode
2 - How to Set Up the MagneFlex Powder V2 API
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 11
Figure 2-2 – Windows 8 Manage Bluetooth Devices App
9) Locate the serial number on the label on the bottom of the device. Note the final four digits.
10) Read through the list of pairable devices and locate the device called DynaProMini-nnnn, where
nnnn is the last four digits of the device’s serial number (if the device does not show in the list, power
it off then power it back on). Below the device name you should see the text Ready to pair.
11) Select the device and press the Pair button. If the device is configured to run in KB mode, Windows
will prompt you Enter the passcode for your keyboard.
12) Enter default passcode 000000 (or the device’s actual password if it has been configured differently),
then press the Next button. Windows will return you to the Manage Bluetooth devices page.
After a short period of time, you will see the text Connected below the device you are pairing with.
After a few seconds the device will disconnect, which is normal power-saving behavior.
2 - How to Set Up the MagneFlex Powder V2 API
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 12
13) Use the host software to test swiping a card. If you do not yet have host software and the device is
configured to run in KB mode, open any text editor and swipe a card. The card contents should
appear in the text editor.
14) The device consumes very little power when not transmitting card data, so it is not necessary to
power off the device to conserve power. If the device appears as Not connected in the Windows
list of Bluetooth devices, swiping a card should cause the device to reconnect briefly, transmit the
card data, then disconnect.
15) Remember to change the default password. See the DynaPro Mini Programmer’s Reference
documents for details.
To unpair from the device:
1) Locate the device in the Manage Bluetooth devices window.
Press the Remove device button.
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 13
3 MagneFlex Powder V2 ResourcesDynaFlex devices
MagneFlex Powder V2 API can be hosted as a Windows service (MagTek Powder (PinPAD, DynaFlex)
Host service or as an executable (MUSDK.WEBAPI.Host.exe).
3.1 CheckHealth
Returns the operational status of the MagnaFlex Powder.
Using Method GET:
api/mtppscrahost/CheckHealth
Return value: A string array containing API name and status.
[
"MagTek PPSCRA WEB API",
"OK"
]
3.2 DisplayMessageV1
Displays a message on the device.
Using Method POST:
api/mtppscrahost/DisplayMessageV1
{
"DeviceID": "",
"WaitTime": ,
"MessageID":
}
Parameter
(Type)
Description
DeviceID (String)
URI of the device. See DeviceID URI for details.
WaitTime (Integer)
Time in seconds to complete the operation.
(1 - 255)
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 14
MessageID
(Integer)
Value representing the message.
For DynaFlex family:
0x01 = “AMOUNT”
0x02 = “AMOUNT OK?”
0x03 = “APPROVED”
0x04 = “CALL YOUR BANK”
0x05 = “CANCEL OR ENTER”
0x06 = “CARD ERROR”
0x07 = “DECLINED”
0x08 = “ENTER AMOUNT”
0x09 = reserved, do not use.
0x0A = reserved, do not use.
0x0B = “INSERT CARD”
0x0C = “NOT ACCEPTED”
0x0D = reserved, do not use.
0x0E = “PLEASE WAIT”
0x0F = “PROCESSING ERROR”
0x10 = “REMOVE CARD”
0x11 = “USE CHIP READER”
0x12 = “USE MAGSTRIPE”
0x13 = “TRY AGAIN”
0x14 = “WELCOME”
0x15 = “PRESENT CARD”
0x16 = “PROCESSING”
0x17 = “CARD READ OK - REMOVE CARD”
0x18 = “INSERT OR SWIPE CARD”
0x19 = “PRESENT ONE CARD ONLY”
0x1A = “APPROVED PLEASE SIGN”
0x1B = “AUTHORIZING PLEASE WAIT”
0x1C = “INSERT, SWIPE OR TRY ANOTHER CARD”
0x1D = “PLEASE INSERT CARD”
0x1E = Null prompt (empty screen)
0x1F = reserved, do not use.
0x20 = “SEE PHONE”
0x21 = “PRESENT CARD AGAIN”
0x22 = “INSERT/SWIPE/TRY OTHER CARD”
0x23 = “TAP or SWIPE CARD”
0x24 = “TAP or INSERT CARD”
0x25 = “TAP, INSERT or SWIPE CARD”
0x26 = “TAP CARD”
0x27 = “TIMEOUT”
0x28 = “TRANSACTION TERMINATED”
For DynaPro family:
0x00 = Blank
0x01 = Approved
0x02 = Declined
0x03 = Cancelled
0x04 = Thank You
0x05 = PIN Invalid
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 15
0x06 = Processing
0x07 = Please Wait
0x08 = Hands Off
0x09 = PIN PAD not available
0x0A = Call Your Bank
0x0B = CARD ERROR
0x0C = Not Accepted
0x0D = Processing Error
0x0E = Use CHIP READER
0x0F = Refer to your payment device
0x80..0x83 = Bitmap in slots 1..4
0xFF = Custom Bitmap Message
Return value:
{
"DeviceID": "",
"ResultStatus": ,
"ResultMessage": ""
}
Parameter
(Type)
Description
DeviceID (String)
Device ID returned from RequestDeviceList.
ResultStatus
(Boolean)
Status of the operation.
false = fail
true = success
ResultMessage (String)
Message explaining the status of the operation.
Example Request/Response:
{
"DeviceID": "",
"WaitTime": 5,
"MessageID": 1
}
{
"DeviceID": "[USB DynaFlex] B62CA53",
"ResultStatus": true,
"ResultMessage": "feature_display_message,status_timed_out"
}
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 16
3.3 EndPINSessionV1
Ends the PIN session on the device. RequestPINWithPANFromCardV1 or
RequestPINWithSuppliedPANV1 must be called beforehand to start the PIN session. The host app
makes the determination of which status to display on the device.
Using Method POST:
api/mtppscrahost/EndPINSessionV1
{
"DeviceID": "",
"Option": ""
}
Parameter
(Type)
Description
DeviceID (String)
URI of the device. See DeviceID URI for details.
Option
(String)
Status to display on the device.
Success = “PIN Entry Successful”
Failed = PIN Entry Failed”
Cancel = “PIN Entry Canceled”
Return value:
{
"DeviceID": "",
"ResultStatus": true,
"ResultMessage": "",
"State":
}
Parameter
(Type)
Description
DeviceID (String)
Device ID returned from RequestDeviceList.
ResultStatus
(Boolean)
Status of the operation.
false = fail
true = success
ResultMessage (String)
Message explaining the status of the operation.
State
(Integer)
State of the PIN session.
0 = Unknown
1 = End
2 = Started
Example Request/Response:
{
"DeviceID": "",
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 17
"Option": "Success"
}
{
"DeviceID": "",
"ResultStatus": true,
"ResultMessage": "Session Ended",
"State": 1
}
3.4 ReleaseDeviceV1
Closes the connection to the device. This operation is not applicable on a device which was already
closed.
Using Method POST:
api/mtppscrahost/ReleaseDeviceV1
{
"DeviceID": ""
}
Parameter
(type)
Description
DeviceID (String)
URI of the device. See DeviceID URI for details.
Return value:
{
"DeviceID": "",
"ResultStatus": ,
"ResultMessage": ""
}
Parameter
(Type)
Description
DeviceID (String)
Device ID returned from RequestDeviceList.
ResultStatus
(Boolean)
Status of the operation.
false = fail
true = success
ResultMessage (String)
Message explaining the status of the operation.
Example Request/Response:
{
"DeviceID": ""
}
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 18
{
"DeviceID": "",
"ResultStatus": true,
"ResultMessage": "All devices are released!"
}
3.5 RequestDeviceListV1
Returns a string array containing name/value pairs of devices detected on the host based on device type.
Using Method POST:
api/mtppscrahost/RequestDeviceListV1
{
"DeviceType": ""
}
Parameter
(Type)
Description
DeviceType
(String)
Type of device to detect.
MMS = DynaFlex family
PPSCRA = DynaPro family
Empty string for both MMS and PPSCRA devices
Return value:
{"Devices": [{
"DeviceID": "",
"DeviceType": "",
"ConnectionType": "",
"Address": ""
},
{
"DeviceID": "",
"DeviceType": "",
"ConnectionType": "",
"Address": ""
}]
}
Parameter
(Type)
Description
DeviceID (String)
Device ID. This is used in API resources where DeviceID is required.
DeviceType
(String)
Type of device detected.
MMS = DynaFlex family
PPSCRA = DynaPro family
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 19
ConnectionType
(String)
Device communication interface to the Host.
USB
WEBSOCKET
SERIAL
BLE
Address (String)
Address of the device.
Example Request/Response:
{
"DeviceType": "MMS"
}
{"Devices": [{
"DeviceID": "[USB DynaFlex] B62CA53",
"DeviceType": "MMS",
"ConnectionType": "USB",
"Address":
"\\\\?\\hid#vid_0801&pid_2020#6&1faf27ac&0&0000#{4d1e55b2-f16f-11cf-
88cb-001111000030}"
}]}
3.6 RequestManualCardV1
Prompts the user to manually enter card data.
Using Method POST:
api/mtppscrahost/RequestManualCardV1
{
"DeviceID": "",
"WaitTime": ,
"Amount":
}
Parameter
(Type)
Description
DeviceID (String)
URI of the device. See DeviceID URI for details.
WaitTime (Integer)
Time in seconds for each prompt on the device screen to be completed.
(1 - 255)
Amount (Decimal)
Transaction amount
Return value:
{
"DeviceID": "",
"ResultStatus": true,
"ResultMessage": "",
3 - MagneFlex Powder V2 Resources DynaFlex devices
SDK - MagneFlex Powder, Middleware| PIN PEDs | Programmer’s Manual ( MagneFlex Powder V2 API )
Page 20
"DataBlob": "",
"CardManualOutput": {
"CardOperationStatus": ,
"CardStatus": ,
"CardType": ,
"DataType": ,
"EncryptedMagnePrint": "",
"EncryptedTrack1": "",
"EncryptedTrack2": "",
"EncryptedTrack3": "",
"EncryptedMagnePrintLength": ,
"EncryptedMagnePrintStatus": ,
"EncryptedTrack1Length": ,
"EncryptedTrack1Status": ,
"EncryptedTrack2Length": ,
"EncryptedTrack2Status": ,
"EncryptedTrack3Length": ,
"EncryptedTrack3Status": ,
"MagStripeStatus": ,
"PANDataLength": ,
"Track1Length": ,
"Track1Status": ,
"Track2Length": ,
"Track2Status": ,
"Track3Length": ,
"Track3Status": ,
"StatusCode": ,
"CardData": "",
"CBCMAC": "",
"KSN": "",
"MagnePrintStatus": "",
"PANData": "",
"MagTekSerialNumber": "",
"Track1": "",
"Track2": "",
"Track3": ""
},
"StatusCode": ,
"AdditionalOutputData": null
}
Parameter
(Type)
Description
DeviceID (String)
Device ID from the request.
ResultStatus
(Boolean)
Status of the operation.
false = fail
true = success
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89

Magtek MPPG Services Programming Manual

Type
Programming Manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI