Geidea

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

Setup

Geidea website

Dependent DLL

This integration calls an API from an unmanaged DLL. Since this DLL is unmanaged, we cannot package it with the plugin. Here are the steps to install the DLL:

  • Dev Environment: A post-build step has been added to the Geidea project that will copy the DLL to the required directory. In this setup, simply building the project will install the DLL to the correct directory.
  • Prod Environment: In production environments, the madaapi_v1_9.dll will need to be copied to C:\LSPay\geidea on all machines hosting the LS Pay service.

PED - PAX A920 Pro

Device setup requires Geidea support staff to add the device to their test environment, they will walk you through the necessary settings to configure on the PED.

Hardware Station Settings

This implementation supports 2 connection types, USB and TCP.

TCP Connection Type

  1. Set the connection type to TCP
  2. Enter the IP address of the terminal device
  3. Enter port number 6100

USB Connection type

  1. Set the connection type to USB
  2. Enter the COM port of the USB device. This can be retrieved using the following steps.
    1. Open device manager and expand the Ports (COM & LPT) section
    2. Before plugging in the device, take note of the currently used COM ports
    3. Plug the device in
    4. Take note of the new device(s) that were added. Use the first new COM port that was not in the section before plugging the device in

Troubleshooting

Timeout issues

If the connection to the terminal is not closed properly (i.e. POS crashes, unhandled error occurs before connection is closed, etc.), you may start seeing timeout errors for all requests sent to the terminal. This can be fixed by restarting the terminal device.

Settings

  • Connection Type: Determines how the POS will connect to the PED. TCP and USB connections are supported
  • IP Address: The IP address of the PED.
  • Main Port: If using TCP connection, this will be the port number the device is listening on for requests. If using USB connection, this will be the COM name of the USB device
  • Receipt Characters: Sets the character length for the width of the receipts
  • Timeout: Sets the amount of time in seconds the POS will wait for the device to respond to a request

 

EFT (Electronic Fund Transfer)

Supported features

  • Purchase

    • Returns a purchase response
    • The response will only show authorization statuses of Approved or Declined

  • Refund

    • Returns a refund response

  • Void

    • Returns a void response or an error if the transaction cannot be voided
    • A transaction can only be voided within 60 seconds

  • GetLastTransaction

    • Returns a response containing the information from the last response the PED sent to the POS

  • Z Report

    • Returns a response containing a receipt showing the reconciliation report
    • Terminal also shows the report on the screen and can be printed directly from the terminal

Barcode Scanner

  • Not implemented