MX51

This article describes the implementation of the MX51 in the LS Pay Engine.

MX51 website

Settings

  • API Endpoint:API Endpoint for MX51, default is http://localhost:8282/v1.
  • Timeout in seconds: Timeout of transaction, default set to 90 seconds.
  • Content Type:Default is set to application/json.
  • Receipt line width: Width of the receipt in characters, default set to 40.

LS Pay Engine will will send a ping request for each transaction and if the ping is successful then it only proceeds to send the transaction request.

Prerequisites

  • Spice app from MX51 must be installed on the POS machine.
  • Print customer receipt from Terminal enabled on Spice.
  • Print merchant receipt enabled in Spice.
  • Confirm customer signature on Terminal enabled on Spice.
  • Clients must use EFT terminal equiped with printers.
  • LSC extension must be installed at POS for transaction recovery scenario (this is owned by APAC Consultancy)
  • Mandatory fields on the plugin configuration must be filled. for example: MX51 API URL. default: http://localhost:8282/v1. Content type: application/json . The rest can be left with default values.
  • Android device is required to install the Gecko bank which is used by MX51 as terminal emulator in testing environment. This requires MX51 to add the registry. The Geko bank can be downloaded from Google play store once the access is granted.
  • The API documentation can be found in https://developer.mx51.io/docs/spice-overview.
  • The terminal user guide is placed under same documentation folder.

Installation

  1. Install Spice on POS machine. The Spice installed can be downloaded from https://developer.mx51.io/docs/spice-overview and proceed to run the exe.
  2. Enable the required configuration on Spice.
    1. Print customer receipt from Terminal enabled on Spice.
    2. Print merchant receipt enabled in Spice.
    3. Confirm customer signature on Terminal enabled on Spice.
  3. Setup the Gecko bank terminal on an android device. The manual included in the documentation folder.
  4. The spice app must be paired with Gecko bank terminal using the IP address displayed on the terminal.
  5. Confgiure the LSPay MX51 plugin for required fields.
    1. Mandatory fields on the plugin configuration must be filled.
    2. Default value is auto assigned.
    3. ContentType: application/json.
    4. HttpEndpoint: http://localhost:8282/v1.

EFT (Electronic Fund Transfer)

Supported features

  • Purchase

  • Refund

    • Referenced refund

    • Standalone refund

  • Get Last Transaction

Reports

  • X Report

  • Z Report