Skip to main content
Contact Us

How can we help?

Orbit Client Configuration Guide (Pay App 1.10+)

  • Updated

 

 

Introduction

This article will provide a guided walkthrough for configuring an Orbit compatible Terminal covering the configuration from both the Linkly Orbit Client and Terminal device.

Please note:
This article covers instructions specific to the Linkly Payment App from version 1.10 and above.

 

 

Prerequisites

  • The latest Linkly Client installed on your PC system. Latest Orbit version can be found on our website here.
  • The pinpad terminal already connected to the local network, by either Ethernet, RNDIS or Wifi.
    Steps to configure the network settings can be found here.

 

 

Client

After choosing to install Linkly Orbit, you can open the Linkly Client GUI from the Windows task bar on the bottom right of your screen by clicking on the yellow or green 'C' icon.

 

  • Once the Linkly Client GUI window is open, make sure the Com Port field is set to 'TCPIP'.
  • Use the Printer field to configure your printing options. 
    The client can be set to print directly to the pinpad terminal, forward print tasks to the POS application, or print to a specific local Windows printer. Please see below for the corresponding value to enter into the printer field.

NPT

 This will configure the Client to send receipts and print outs to be printed to the pinpad terminal directly.

" "

 Leaving the Printer field empty direct the Client to forward receipts and print outs to the POS application to handle.

<Printer Name>

 Alternatively, inputting the locally connected windows printer name will direct the Client to forward receipts and print outs to the windows printer. 
(Printer names found within Windows 'Printers and Scanners' settings).

Following these changes, press 'Apply' to on the top right of the Linkly Client GUI to save your changes.

LinklyClient_Orbit_01.jpg
Example of the correct Linkly Client configuration for an Orbit Integration.

 

 

 

 

Terminal

Once the Linkly Orbit Client is set up as above, to use the Orbit device with your POS in integrated mode, connect the Terminal to your Windows PC or POS through the Client.

There are two connection methods the that the terminal can connect to the Client via the PC:

  • TCPIP which can utilise the local network either from Ethernet, Wifi or RNDIS (Windows ICS).
  • Serial or USB which can utilise a physical cable between the pinpad device and the PC.

There is also an integration method called MPOS or Local Rest which allows the terminal to communicate directly to in built POS application, so no Client integration is needed.

For each of these communication methods, the Terminal may utilise a Base for the primary communications, steps on how to set this up can be found below.

 

 

 

Base Pairing

The base stabilises the Terminal device when stationary and can be easily removed by lifting it off. It also acts as a charging dock and connects the Terminal to the POS system via serial ports at the back.

Before docking, connect your chosen communication cable (Ethernet, Serial, USB) and the AC power adapter to the base. Then, place the Terminal on the base and ensure it is charging.

To use Ethernet, Serial, or USB through the Terminal Base, the Terminal will need to be associated via Bluetooth or Wifi to the Base, please follow these steps below.

  • On the Terminal, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'Setup Wifi Base'.
    • Following this option will switch to the Cradle App, select 'Wifi Settings'.
    • Within the Android Wifi menu, select the Wifi AP of the Base and enter the password, finalise by tapping on 'Connect'. After the Terminal has connected to the Bases Wifi, the App will redirect to the POS Settings menu.
  • Once in the 'POS Settings' menu, select 'Serial' as the POS Method.
  • For Serial Type, tap on 'Serial via Base'.
  • Select '115200' as the Baud rate.
  • Tap on 'Apply' to finalise and store the settings.

 

 

Terminal Network Configuration

To connect the Terminal device to Wifi or Ethernet, please follow the steps below.

Wifi

  • On the Terminal, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'Wifi Settings', this will redirect to the Android systems Wifi configuration.
  • Choose your prefered Wifi AP from the list and enter the password to finalise.

 

Ethernet

  • Connect the Ethernet cable into the back of the Terminal or the Base.
  • On the Terminal, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'Ethernet Settings', this will redirect to the Android systems Ethernet configuration.
  • Toggle 'Use Ethernet', and confirm the IP address field is populated.

 

 

 

 

TCPIP (Wifi / Ethernet) Connection

To connect the pinpad device to the Linkly Client via the TCPIP method, follow the steps below.

  • On the Terminal, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'POS Settings', then once in this menu, under 'POS Method', choose 'TCPIP'.
  • Enter the IP address or Hostname of the POS.
  • Enter the Port number of '2012'.
    (To allow the Linkly Pay App to monitor network traffic, switch the 'Enable VPN' toggle on.)
  • Tap on 'Apply' to finalise and store the settings.

 

 

USB / Serial Connection

To connect the pinpad device to the Linkly Client via the Serial or USB method, follow the steps below.

  • On the Terminal, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'POS Settings', then once in this menu, under 'POS Method', choose 'Serial'.
  • In the 'Serial Type' drop down, select one of the following options below based on your connection method.
    • USB on Device: Connect using a USB cable directly into the Terminal device.
      (This config is currently unavailable).
    • Serial via Base: Connect using Serial cable to one of the COM1, COM2, COM3 ports on the back of the base.
    • Serial USB via Base: Connect using a USB cable to the back of the base.
  • In the 'Baud Rate' drop down, set the speed of data transfer to '38400'.
    (To allow the Linkly Pay App to monitor network traffic, switch the 'Enable VPN' toggle on.)
  • Tap on 'Apply' to finalise and store the settings.

 

 

RNDIS Connection

To utilise the terminal device to connect via RNDIS (USB or Ethernet) you will need the terminal device to be associated with the Base. Please follow the steps below for either Ethernet or USB.

Ethernet

  • Connect the Base to power using the power socket on the back of the device.
  • Using the Ethernet cable running from the Router AP, plug the Ethernet cable into the LAN port on the back of the base.
  • Once the device is placed on the base, the Ethernet cable is attached, proceed to the Base Pairing step.

USB

  • Connect the Base to power using the power socket on the back of the device.
  • Plug the USB cable into the USB Device port on the back of the base.
  • Once the device is placed on the base, the USB cable is attached, proceed to the Base Pairing step.

 

 

 

Local Rest (MPOS) Connection

To connect the terminal device via Local Rest or MPOS, please follow the steps below.

  • Firstly, on the Terminal itself, press the hamburger menu (three lines) at the top right of the main screen.
  • Tap on 'Config', then 'Hardware Config'.
  • Tap on 'POS Settings', from this page, select the 'POS Method' drop down and choose 'Local Rest'.
  • Tap on 'Apply' to save these changes then go back to the main Menu.
  • Second, Tap on 'Config', then 'Actions'.
  • Tap on 'Standalone MPOS App'.

Once you're in the MPOS app, you will need to configure the settings specific to your POS setup.

 

 

 

 

 

Related to:

Related articles

Contact Us