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
Download the latest version of the EMVUSClient™ Test application on datacapepay.com under the Diagnostics/Utilities section.
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.
Select "Tran_EMV" from the Pad/Processor list on the left side of the application window.
Match the Com ports for the IPTran™ LT using Windows Device Manager (access from Control Panel > Device Manager).
Perform a "PIN Pad Reset" to confirm connection with the EMV-enabled PIN Pad, and reset it to "idle" state.
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.
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
- 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").*
Select the PIN Pad being used (see the Pad/Processor list on the left side of the EMVUSClient Test application).
Match Com ports for the EMV-enabled PIN Pad using Windows Device Manager (access from Control Panel > Device Manager).
Perform a "PIN Pad Reset" to confirm connection with the connected EMV-enabled PIN Pad, and reset it to "idle" state.
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.
If receipt data is not returned, it is not displayed. You should receive no additional dialog.
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".
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
Required for Vantiv IP
Click the "EMV Sale" button to initialize a test transaction.
An "EMV Sale" will return an XML stream (NETePay) or a string of AT commands (Tran).
Click "OK" to continue to the next prompt.
Troubleshooting and Error Messages
©2016-2017 Datacap Systems, Inc. All Rights Reserved.