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.

Driver Installation

Click on Open and locate the MAGTEK MTSCRA WEBAPI Host Service and verify that the status displays Running.

Driver Installation

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.

POS Certificate

  • On the File menu of MMC, select Add/Remove snap-in.

POS Certificate

  • In the Add or Remove Snap-ins dialog box, select Certificates, and then select Add.

POS Certificate

  • In the Certificates snap-in dialog box, select Computer account, and then select Next.

POS Certificate

  • In the Select Computer dialog box, select Local Computer, and then select Finish.

POS Certificate

  • In the Add or Remove Snap-ins dialog box, select OK.

POS Certificate

  • In the left pane of the console, double-click Certificates (Local Computer) to expand the contents.

POS Certificate

  • Right-click Personal, point to All Tasks, and then select Import.

POS Certificate

  • In the Certificate Import Wizard dialog, select Next.

POS Certificate

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

POS Certificate

  • Back in the Certificate Import Wizard dialog, select Next.

POS Certificate

  • Enter “localhost” in the password field on the Password page and check the Mark this key as exportable option then select Next.

POS Certificate

  • On the Certificate Store page, select Automatically select the certificate store based on the type of certificate then select Next.

POS Certificate

  • Select Finish then select OK to confirm that the import was successful.

POS Certificate

STEP 3: Reconfigure the Magneflex Application

  • Open the C:\Program Files (x86)\MagTek\MTSCRA WEBAPI\MTSCRA.WEBAPI.HostService.exe.config file for editing.

POS Certificate

  • Set the BASEADDRESS value to “localhost:9000” and the PROTOCOL value to “HTTPS” then save the file.

POS Certificate

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

POS Certificate

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}

POS Certificate

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”

POS Certificate

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.

POS Certificate

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.

Trouble Shooting