POS Magtek MTSCRA WEB API Installation for eDynamo¶

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:

1. 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.

2. 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.