Skip to main content
Contact Us

How can we help?

Linkly Virtual Pinpad Guide

  • Updated

 

Introduction

Linkly provide a Virtual Pinpad for development and testing purposes which is a standalone application that can be connected to the Linkly Client to simulate a physical pinpad terminal device.
The VPP can be manually configured for both On-Premises and Cloud integration types.

 

 

Download and Install the Virtual Pinpad

You can download the latest version of the Linkly Virtual Pinpad below.
(Once downloaded, extract the .zip and run the 'VirtualPinpad.exe' executable).


 

Please note:
The Virtual Pinpad requires Microsoft Visual C++ Redistributable 2015, 2017, 2019 (x86).
If you attempt to run the VPP and see errors involving MFC140.DLL or VCRUNTIME.DLL then its possible you do not have Visual C++ installed on your computer.

Download the latest Visual C++ Redistributable here.
(Regardless of the processor architecture, both the x64 and x86 packages must be installed).

 

 

 

Virtual Pinpad Configuration

 

Linkly Client Configuration

  1. Click on the green 'C' icon to open the Linkly Client from the Windows taskbar.
  2. Locate the COM port field and select TCPIP the dropdown field, finalise by clicking apply.

 

On-Premise Configuration

By default the VPP will be automatically configured for On-Prem mode. 
If this is your first time opening the executable or have reset the VPP and plan on using the VPP for a local connection, please skip this step.

  1. Open the VirtalPinpad.exe file.
  2. Enter the Function code '7410', then press OK.
  3. The VPP will now display 'Terminal Configuration'.
    Press '0' to switch to disable Cloud mode, then press 'OK'.
  4. Enter the 'Client IP' of '127.0.0.1', then press 'OK'.
  5. Enter the 'Client Port' of '2012', then press 'OK'.
  6. From the 'Reconnect to Client?' prompt, press 'OK', then 'Cancel' to return to the home page.

Following these steps the VPP should be connected to the Linkly client locally via port 2012. If the VPP is still not online, try restarting the Linkly Client services but right clicking the green or yellow C icon in the taskbar and choose 'Restart Client Services'.

 

 

Cloud Configuration

Use this configuration when connecting the Virtual Pinpad (VPP) to the Linkly Cloud integration type.

  1. Open the VirtualPinpad.exe file.

  2. Enter the Function code '7410', then press OK.

  3. The VPP will now display 'Terminal Configuration'.
    Press '0', then press OK.

  4. The VPP will now display 'Cloud Mode'.
    Press '1' to turn Cloud Mode On, then press OK

  5. The VPP will now display 'Reconnect to Client?', press OK.

  6. The VPP will display 'Terminal Configuration', press Cancel.

  7. The Pinpad will now attempt to connect to the Linkly Cloud Client.
    You may need to restart the Pinpad if it doesn’t connect automatically.

  8. Once ready, the Pinpad should display 'Pinpad pairing press enter'.

 

 

 

Additional VPP Functionality

The Virtual Pinpad includes a suite of additional features and functionality. 
To configure the different options below, press 'Func' then enter '7410', then press either option 1, 2 or 3 depending on which setting to change.
Pressing 'OK' is YES and 'Clear' is NO.

 

Option 1 - Interaction Settings

  • Test Dialogues
    This will simulate Linkly Client to POS prompts.
  • Toggle Auto Approve
    by default the VPP will automatically approve all transaction, disabling this will configure the VPP to decline transactions based on the cent value sent in the initial request.

 

Option 2 - Receipt Prompts

  • Prompt for Customer receipt
    Enabling this option the VPP will prompt for the Customer copy to be generated to either the Client or VPP print screen on the right panel.
  • Prompt for Merchant receipt
    Enabling this option the VPP will prompt for the Merchant copy to be generated to either the Client or VPP print screen on the right panel.

 

Option 3 - VPP GUI Resolution (requires application restart)

  • 0 is the largest, best for visibility (default setting).
  • 1, 2 and 3 are progressively smaller resolutions.

 

To manually alter the Virtual Pinpad files further, the VPP user data config file DefaultPinpad is located in ./pp_users. 

Remove the pp_users directory will reset or revert the VPP back to the default settings.

 

 

 

Additional Client Configuration

The steps below are not required for the VPP The Linkly Client itself can be further configured to support different ports used to communicate from the VPP (or a wireless terminal) and the Linkly client.

To configure the Virtual Pinpad to connect to Linkly you can elect a port to be used (the default TCP port is 2012) and configure this in the registry as well as the configuration file for the Virtual Pinpad 

 

Registry Configuration

  1. Open the registry editor.
  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\CullenSoftwareDesign\EFTCLIENT\PINPAD.
  3. Locate the String named Port and change the contents to TCPIP.
  4. If you do not wish to use the default port (2012), locate the D_WORD key named IP_PINPAD_PORT and set the contents to the port of your choice (you may have to create the key If It does not exist).
  5. Ensure you restart the 'Linkly Client" service in Windows Services to apply the changes.

 

 

Host Response / Cent Values

For specific testing purposes, the Virtual Pinpad can replicate certain Host Response codes to simulate different error or approvals. To use this functionality, send a transaction request with the cent value of the host response code you wish to simulate. For example, sending a transaction request for $1.00 will simulate a '00' approved response, while sending a request for $1.33 will simulate a '33' Expired card decline.

 

Related articles

Contact Us