POS Magtek MTSCRA WEB API Installation for eDynamo¶
Note
MagTek SCRA WEB API - PN1000003788 - v108
The MTSCRA WEB API provides demonstration source code and reusable MTSCRA WEBAPI DLLs that provide developers of custom software solutions with an easy-to-use interface for Dynamag, DynaMAX, and eDynamo. Developers can include the MTSCRA WEBAPI DLLs in custom branded software which can be distributed to customers or distributed internally as part of an enterprise solution.
Compatability Requirements:
Tabular Format
Device | Connection Type | Operating System |
---|---|---|
Windows PC | USB | Windows 7/8.1/10 |
Windows Tablet | USB Bluetooth LE* |
Microsoft Surface Go (works on all tablets that run a supporting OS) |
iPad and iPhone | Bluettoth LE* | IOS 7.1 or newer |
Andriod Phones and Tablets | Bluetooth LE* | Andriod 4.4.4 or newer |
*Requires installation of the Wedget keyboard application from Magtek. The Wedget keyboard should be selected before swiping or dipping the card (This is only a requirement when using Forte Checkout via Bluetooth on Android or iOS devices). Additionally, to use the Wedget keyboard with eDynamo, you must submit a ticket to Forte Technical Support to get your device added to MagTek's Wedget database.
STEP 1: Before installing the Certificate, please download and install the Magtek eDynamo Package.
When the above package is installed, we can verify as below:
Click on the Start button on the computer and type Services.
Click on Open and locate the MAGTEK MTSCRA WEBAPI Host Service and verify that the status displays Running.
STEP 2a: The Client CA Certificate File must be downloaded and has to be uploaded as part of the Magtek software installation.
STEP 2b: The following are the steps to be followed to install the certificate:
Import the Client Certificate
-
On the Windows System, select Start .
-
In the Search programs and files box, type mmc.exe, then right-click on the mmc.exe search result and select Run as administrator. If the User Account Control dialog opens, select Yes.
- On the File menu of MMC, select Add/Remove snap-in.
- In the Add or Remove Snap-ins dialog box, select Certificates, and then select Add.
- In the Certificates snap-in dialog box, select Computer account, and then select Next.
- In the Select Computer dialog box, select Local Computer, and then select Finish.
- In the Add or Remove Snap-ins dialog box, select OK.
- In the left pane of the console, double-click Certificates (Local Computer) to expand the contents.
- Right-click Personal, point to All Tasks, and then select Import.
- In the Certificate Import Wizard dialog, select Next.
- On the File to Import page, select Browse, find the client CA certificate file from the location where it was downloaded (Refer STEP 2a), and then select Open.
- Back in the Certificate Import Wizard dialog, select Next.
- Enter “localhost” in the password field on the Password page and check the Mark this key as exportable option then select Next.
- On the Certificate Store page, select Automatically select the certificate store based on the type of certificate then select Next.
- Select Finish then select OK to confirm that the import was successful.
STEP 3: Reconfigure the Magneflex Application
- Open the C:\Program Files (x86)\MagTek\MTSCRA WEBAPI\MTSCRA.WEBAPI.HostService.exe.config file for editing.
- Set the BASEADDRESS value to “localhost:9000” and the PROTOCOL value to “HTTPS” then save the file.
STEP 4: Unbind the certificate from the MagneFlex application
If you are replacing an existing certificate bound to the MagneFlex application, you must unbind the existing certificate before binding the new certificate. Skip this step for new installations.
Open a CMD prompt with Run as Admin and run the following command:
netsh http delete sslcert ipport=0.0.0.0:9000
Bind the certificate to the MagneFlex application
Open a CMD prompt with Run as Admin and run the following command:
netsh http add sslcert ipport=0.0.0.0:9000 certhash=698D62201307FC6D9DAD4E3837C4383146C4DD8B appid={00112233-4455-6677-8899-AABBCCDDEEFF}
STEP 5: Restart the Magtek MTSCRA Host Service
In that same Admin CMD prompt, run the following two commands:
net stop “MagTek MTSCRA WEBAPI Host Service”
net start “MagTek MTSCRA WEBAPI Host Service”
STEP 6: Set the Service Failure Restart Properties
In the service properties of “MagTek MTSCRA WEBAPI Host Service” set the First failure, Second failure and Subsequence failures to “Restart the Service”
Save and Restart the service.
Trouble Shooting
For trouble shooting the wireless device(s) the following steps need to be performed:
-
Important!!! Make sure that the Recovery behavior from the earlier step is setup. It is required that the recovery behavior is set for the Card readers to work with the Vela application.
-
Reset and Pair the reader
a. Un-pair and remove the e-Dynamo from the Bluetooth device list.
b. Reset the device: To do this, press and hold the button for 15 seconds. After 15 seconds, the General Status LED will blink and the device will power off. To complete the reset, turn the device back on by pressing the button again.
c. Pair the device. The Bluetooth security code is needed to pair the device. Use 000000 for the pairing code.