MarketPay

In this article

Settings

Connection

Hardware

EFT

This article describes the implementation of the MarketPay PAX PEDs in the LS Pay Engine.

MarketPay documentation

MarketPay API documentation

Settings

To access the settings from the MarketPay application on the terminal, tap 7 times in the top right corner within 2 seconds. Enter the password pax9876@@ and choose Settings.

The following information is needed to be able to use the terminal:

  • Serial number of the terminal. Found on the back of the terminal.
  • IP address of the terminal. Found in the Network & Internet settings on the terminal. The password to access the settings on the terminal is pax9876@@.
  • Port number: 7778 is used for the testing environment.
  • Timeout in seconds: 60
  • Operator ID: cashier001
  • Operator language: EN
  • Currency Code: ISK
  • Receipt Width: 40
  • Protocol Version: 3.1

Connection

This plugin uses a TCP/IP connection. Connection to the terminal is through an ethernet connection or Wi-Fi.

To establish a connection to the terminal, a Login Request is sent. This is sent when clicking Load Plugin when testing. It is mandatory to send the Login Request at the start of the application before sending any other request (such as a purchase request).

If the response from the Login Request does not come through, open the Pay On Site application on the terminal while sending the login request. If you are trying to access the app from the MarketPay app, tap the top right corner 7 times within 2 seconds, enter the password pax9876@@, and choose the Pay On Site application.

To terminate a session, a Logout Request is sent. This is sent when clicking Unload Plugin when testing.

Hardware

Tested on PAX A35.

EFT

  • Purchase
    • The receipt is part of the response received from MarketPay.
  • Refund
    • Only standalone refund is supported.
  • Abort
    • It is possible to cancel the in-progress transaction from the terminal or from the POS.
  • Reversal
    • Voids a transaction that has been processed and successfully approved by the system.
  • Transaction Status
    • This request is used like GetLastTransaction since, in the current implementation, only the last message will be returned.
  • Update Application
    • Triggers the Payment Terminal to download the latest configurations. A Login Request is sent first to establish a connection to the terminal, then the update request is sent.
    • This is sent when clicking Test Update and choosing Update as the terminal action.
    • At the moment, there is an issue when sending another request after sending an update request. The error "connection closed by remote host" will be displayed. MarketPay is currently working on this issue.