Windward Software Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Datacap/NetePay Troubleshooting ======
If you are having speed or performance-related issues using PINpad's and Datacap consider the following.

===== Capture the Information =====
To be able to understand what might be causing an issue is first to understand the environment and methods that are causing the issue.

  * What is the operating system?
  * What is the device Make, Model, Revision, and Firmware?
  * How is it connected to the computer?
  * What version of Datacap?
  * What version of System Five?
  * What version of the RMR Remote POS Device Manager?
  * Is it credit/debit/gift?
  * Is it EMV, Tap or Swipe?

===== Review Logs =====
Review the logs to see where the time or error is being produced.  What is the specific amount of time that is elapsing.  There are 3 places for time to be used up when processing a credit card.
  - Communication with the device
  - Communication with the processing network
  - Communication via the RMR Remote POS Device Manager

Review the Events tab in the RMR Remote POS Device Manager.  This will contain date and time stamps of the workflow.
{{::posdevice-events.jpg|}}

You can also review the Events_logs folder typically located in the user's directory for additional detail.

===== Check Datacap Version =====

Check you are running the most [[http://www.datacapepay.com/|recent version of DataCap dsiEMV and dsiPDCX]].  Many times there are software updates that can improve performance with devices.  This will need to be performed on all workstations with performance issues.

{{::datacap-dsiemvus.png|}}

<note tip>Ensure you have installed using administrator rights on any workstation or server you are installing NETePay.  This can be done by right-clicking the installer and choosing to "Run as administrator".</note>

===== Check RMR Remote POS Device Version =====

Windward Software provides updates to the [[remote_pos_device_manager|Remote POS Device Manager]] from time to time. These updates improve reliability, performance, and offer updated device support. Work with Windward Software customer care to install an updated version.  This will need to be performed on all workstations with performance issues.

===== Check PINPAD Device Fireware Version =====
Check your device firewire version which [[https://youtu.be/fd3WhhnaCRk?t=24|should show when starting]].  Your PINpad firmware may have bulletins posted by your credit card processor or have specific updates from Datacap.

  * [[https://datacapsystems.com/compatible-devices|EMV PINpad options]]
  * [[https://www.jrorders.com/assets/images/VX805%20XPI%208%20EOP_Partner%20Message%2012302018.pdf|VX805 XPI 8.42B End of availability from Worldpay March 31, 2019]]

===== Check Operating System =====
Ensure the Microsoft operating system is on our [[system_requirements#workstation|supported list]].  Also, ensure the Microsoft operating systems are patched with **no pending patches** that need to be applied.  Pending patches will place the operating system into a degraded state which can cause instability in applications until it is restarted.

===== Check DNS =====
Domain Name Services is configured and typically provided by a customer's internet service provider.  If DNS is incorrectly configured, this can cause up to 30-second delay intermittently while DNS times out and tries another DNS server.  It will work sometimes and take a long time other times.  We have seen this when a customer changes internet providers and only types in the new DNS information provided by the new provider and leaves the old DNS record.

<note warning>Do not make changes to a network.  A customer's IT provider should make these changes.
</note>

To check DNS configuration, at a Windows Command Prompt type in "ipconfig /all".  Validate the Ethernet adapter being used and the DNS.  

<code>
C:\Users\user>ipconfig /all

Windows IP Configuration

   Host Name . . . . . . . . . . . . : WORKSTATION
   Primary Dns Suffix  . . . . . . . : xxx
   Node Type . . . . . . . . . . . . : Hybrid
   IP Routing Enabled. . . . . . . . : No
   WINS Proxy Enabled. . . . . . . . : No
   DNS Suffix Search List. . . . . . : xxx

Ethernet adapter Ethernet 1:

   Connection-specific DNS Suffix  . :
   Description . . . . . . . . . . . : xxxx
   Physical Address. . . . . . . . . : 00-00-00-AA-00-00
   DHCP Enabled. . . . . . . . . . . : No
   Autoconfiguration Enabled . . . . : Yes
   Link-local IPv6 Address . . . . . : 0000::145a:da4:2c8a:2222%22(Preferred)
   IPv4 Address. . . . . . . . . . . : 10.212.134.111(Preferred)
   Subnet Mask . . . . . . . . . . . : 255.255.255.255
   Default Gateway . . . . . . . . . :
   DHCPv6 IAID . . . . . . . . . . . : 1023444445
   DHCPv6 Client DUID. . . . . . . . : 00-00-00-00-25-AA-BB-CC-DD-EE-FF-AA-BB-CC
   DNS Servers . . . . . . . . . . . : 192.168.10.10
                                       192.168.10.11
   NetBIOS over Tcpip. . . . . . . . : Enabled

</code>

To test if the DNS is reachable.  At a command prompt type nslookup.  Enter "server IP_address" to set the server.  Type "google.com" or some other known website name.  The nslookup should return an IP address if working.  If you see a "DNS request time out." That DNS server is not working and resolutions could be removing it from the network configuration or contact the internet provider that their DNS is not operating.

<code>
C:\Users\user>nslookup
Default Server:  servername
Address:  192.168.10.10

> server 192.168.10.11
Default Server:  servername
Address:  192.168.10.11

> google.com
Server:  [192.168.10.11]
Address:  192.168.10.11

DNS request timed out.
    timeout was 2 seconds.
DNS request timed out.
    timeout was 2 seconds.
DNS request timed out.
    timeout was 2 seconds.
DNS request timed out.
    timeout was 2 seconds.
*** Request to [192.168.10.11] timed-out

</code>


===== Debit/Credit Support =====
{{ ::vx805-credit-debit.jpg?200|}}
In North America, some credit cards can be paired with a bank account to support both credit and debit in a single card.  Typically the customer will be prompted to choose which method but the default of this transaction experience comes from the processing bank, deployment credentials and capabilities of the PINpad devices.  

Debit support was added to Datacap NetePay in October 2017.  You can also set Credit/Debit behavior settings in System Five.  In order for these System Five setting to work, the NetePay software, NetePay deployment identifier settings, and firmware of your PINpad need to be configured and able to support credit/debit cards.  

To Enable Credit/Debit:
  * Review your Credit/Debit behavior preference in the [[payment_processing_-_settings#process_as_credit_or_debit|settings in System Five]].
  * Validate your [[https://youtu.be/fd3WhhnaCRk?t=24|PINpad firmware version]] supports [[https://datacapsystems.com/compatible-devices|EMV options]] for credit/debit support.
  * You may require an update to your [[http://www.datacapepay.com/downloadmenu/|Datacap NetePay software]]. (5.07.xx)

^ Datacap 5.06.xx EMV Options     ^ Datacap 5.07.xx EMV Options   ^   
| {{:datacap-emv_5_06.jpg?300|}}| {{::datacap-emv.jpg?300|}}|



===== Netepay Support =====
You can also visit [[https://datacapsystems.com/netepay-support|netepay support]] page to search for any unknown NETePay software errors being experienced.