Datacap's EMVUSClient™ Test application

Datacap's EMVUSClient™ Test application is intended for development and troubleshooting purposes only. It is not designed to be used by merchants or for processing live payments outside of a POS application and must not be used for this purpose.


Scroll down to view this guide or select a topic from the Table of Contents below.

Table of Contents


Installation and Set-up

Step 1:

Download the latest version of the EMVUSClient™ Test application on datacapepay.com under the Diagnostics/Utilities section.

Step 2: 

Run the downloaded executable file to install EMVUSClient™ Test application for EMV transaction diagnostics. Restart computer when installation is complete.


Tran™ Diagnostics Configuration

Make sure the Datacap Tran™ device is plugged into the computer where the EMVUSClient Test application is installed. You will also need a EMV-enabled PIN Pad programmed to your specific processor connected to the Tran device.

Required Fields include:

  • Com Port
Note:  You do not need a Merchant ID or Terminal ID. 

Step 1:

Select "IPTranAT Interface" from the Pad/Processor list on the left side of the application window.

Step 2:

Match the Com ports for the IPTran™ LT using Windows Device Manager (access from Control Panel > Device Manager). 

Windows Device Manager

Windows Device Manager

EMVUSClient Test application

EMVUSClient Test application

Step 3:

Perform a "PIN Pad Reset" to confirm connection with the EMV-enabled PIN Pad, and reset it to "idle" state. 

PIN Pad Reset under "Admin" section

PIN Pad Reset under "Admin" section

A PIN Pad Reset will return a string of AT commands which are being sent to your PIN Pad. Click "OK" to continue to the next prompt which will display the PIN Pad's connection status. 

AT Command response from PIN Pad Reset

AT Command response from PIN Pad Reset

EMVUSClient™ Test application sends a request for receipt data to Tran after every request whether receipt data is available or not. If receipt data is returned it will be displayed; If not, Tran will return an error.


NETePay™ Diagnostics Configuration

Required Fields:

  • Merchant ID is required
  • Terminal ID is required by the following processors: Paymentech, Vantiv, Worldpay US, and First Data Rapid Connect 
  • IP/Hostname is the IP address of the computer you are currently running NETePay on
  • IpPort is the default number of 9000
*Merchant ID might not be called Merchant ID depending on what processor you are using, but will always be the first parameter on your processor provided parameter sheet(e.g. TSYS calls their Merchant ID the "Host Capture POS ID").*

Step 1: 

Select the radio button for “dsiEMVUS” at the bottom left of the application, and then hi-light the Pad/Processor combo that you are using.

dsiEMVUS® in the EMV US Client Test Application

dsiEMVUS® in the EMV US Client Test Application

Selected PIN Pad

Selected PIN Pad

Step 2:

Match Com ports for the EMV-enabled PIN Pad using Windows Device Manager (access from Control Panel > Device Manager). 

Windows Device Manager

Windows Device Manager

EMVClientTest Application

EMVClientTest Application

Step 3:

Perform a "PIN Pad Reset" to confirm connection with the connected EMV-enabled PIN Pad, and reset it to "idle" state.

EMV PIN Pad Reset in EMVClientTest Application

EMV PIN Pad Reset in EMVClientTest Application

A PIN Pad Reset will return a string of XML that is being sent to your PIN Pad. Click "OK" to continue to the next prompt that will display the PIN Pad's connection status. 

XML response from PIN Pad Reset for NETePay

XML response from PIN Pad Reset for NETePay

If receipt data is not returned, it is not displayed. You should receive no additional dialog.  


EMVParamDownload

In this case, we have an IPTran LT connected to com port 3. Press the "EMVParamDownload" button.  The duration of an EMV Parameter varies per processor (generally takes between 1-3 minutes).  Once the EMV Parameter Download is complete, click "Ok".

Your EMVUSClient Test application may look slightly different as we add support for more PIN Pads.

Your EMVUSClient Test application may look slightly different as we add support for more PIN Pads.

Click the button below to learn more about EMVParamDownloads.


Run a Test Sale

Once the EMVClientTest application is set up, you will want to run a test sale to help diagnose your EMV issue. To run a test sale (or any test transaction), the following fields are required:

  • Amount - put in a small dollar amount in the "Amount" field (i.e. $1.00)
  • Reference Number -  This number is automatically generated
  • Invoice Number - The reference number and invoice number of a Test Sale should be the same value
**Some Processors require certain transaction modifiers to be selected in order to run test transactions. See below for TSYS and Vantiv IP (Mercury)**

Required for TSYS

"Allow Partial Auth" is selected for TSYS

"Allow Partial Auth" is selected for TSYS

Required for Vantiv IP

"Allow Partial Auth" and "Use Tokens" Selected for Vantiv IP (Mercury)

"Allow Partial Auth" and "Use Tokens" Selected for Vantiv IP (Mercury)

Click the "EMV Sale" button to initialize a test transaction.

"EMV Sale" for NETePay in EMVUSClient Test application

"EMV Sale" for NETePay in EMVUSClient Test application

An "EMV Sale" will return an XML stream (NETePay) or a string of AT commands (Tran). 

XML Response

XML Response

AT Commands returned

AT Commands returned

Click "OK" to continue to the next prompt.


Troubleshooting and Error Messages

You may encounter error messages while working with the EMVUSClient Test application.  Click the links below to read about common error messages associated with the test application. 

Still need Help?  Contact tech support


©2016-2017 Datacap Systems, Inc. All Rights Reserved.