Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

Overview

This document provides instructions to use the RMS Sample Code. Combining MagTek Linux SDK and web API calls to the Reader Management System (RMS) web service, the sample code assist in setting configurations, key injection, updating EMV Tags/CAPKs, and updating firmware for MagTek readers. The sample code is parsed into a collection of CLI apps (command line interface).

  • Configuration app

  • EMV Tags app

  • Firmware app

For details on the RMS API see: https://rmsv2.developer.magtek.com

Onboarding

This sample code is built with a public RMS Profile. MagTek will provide the necessary Profile configurations and authorization Web API Keys if requested.

Benefits

The MagTek Reader Management System (RMS) provides several key benefits for merchants and businesses, these include:

  • Centralized Management: RMS allows for the remote management and configuration of MagTek readers across multiple locations from a single platform. Merchants can update firmware, keys, terminal settings, and CAPKs without manual intervention, reducing time, cost, and effort.

  • Enhanced Security: RMS supports compliance with industry standards, such as PCI DSS, by ensuring secure payment card transactions and protecting sensitive customer data. It enables a secure process for keeping readers up to date with the latest firmware and configurations.

  • Efficient Updates: RMS automates firmware updates and maintenance, allowing merchants to push updates remotely. This ensures all devices run the latest firmware, enhancing system reliability and reducing the need for manual updates.

  • System Reporting: RMS offers reporting capabilities to track firmware versions and device settings, providing detailed insights by serial number for firmware, terminal, and CAPK updates in both production and test environments.

  • Scalability and Flexibility: RMS is scalable to meet the needs of businesses, whether for a single store or multiple locations.

  • Cost Savings: Automating reader management with RMS reduces the need for on-site visits, lowering maintenance costs and minimizing downtime. Centralized control streamlines administrative tasks, boosting operational efficiency.

  • Improved Customer Experience: Efficiently managed payment readers reduce transaction errors and delays, improving customer satisfaction and loyalty, which positively impacts business reputation and revenue.

Requirements

The following packages are needed on the Linux host to build the sample code. Other dependencies are included in the makefile.

  • make

  • cmake

  • g++

Building RMS Sample Code

  • Unzip the package.

  • Go to Sample folder:

  • Build the sample code using:

Various libraries and folders are generated. The two folders used for RMS Sample code are:

Folder
Description

/rms_mms

For DynaFlex readers: DynaFlex II PED, DynaFlex II Go, DynaProx, DynaFlex Pro, DynaFlex SCRA

/rms_scra

For V5 readers: mDynamo, tDynamo, Dynamag, Dynawave, iDynamo 6, eDynamo, DynaPad

Each sample code folder contains an account credential for access to RMS. This is by default configured for general public use. When accessing RMS for a custom profile, reassign the values as needed in the files: