Skip to main content

Search

We are excited to announce the launch of updated product names, logos, and headers within our user interfaces as part of the CivicPlus® Solution Rebranding initiative. These changes mark the first step toward creating a cohesive and seamless user experience across all solutions in our portfolio. As part of this transition, users may notice minor design updates. While the functionality you rely on remains unchanged, we are in the process of updating screenshots and other resources on our Help Centers to reflect the new branding. We appreciate your patience and understanding as we work to complete these updates.

Converge Payment Terminal Troubleshooting Guide

  • Updated:

This article will demonstrate troubleshooting tips post-setup of Converge payment terminals.

Disclaimer

CivicPlus team members will help troubleshoot issues with API (application program interface) connectivity and API errors. However, CivicPlus Support is not permitted to troubleshoot terminal errors from your payment terminal. Those errors should be reported to your IT department, Elavon Converge, or hardware manufacturer.

 

Article Navigation

 

Pre-requisite

Before following the steps in this guide, please complete the Converge EMV setup process.

 

Commerce Web Services (ConvergeConnect) Troubleshooting Steps

  1. Check to ensure that Commerce Web Services is installed. It should be listed in your control panel. 
    commerce web services.
  2. Ensure that you have the latest version installed. You will need version 4.2 or higher. If you do not have the latest, uninstall Commerce Web Services and download the latest version from Converge.
    about option.
    version number.
  3. Try running Commerce Web Services under administrator privileges. To do this, close all running instances.
    1. Right-click on the ConmmerceWebServices application and select Run as Administrator
      run as admin.
    2. Close and/or shut down all instances of Commerce Web Services. You may have to do this by ending the task in Task Manager.
      end task.
    3. Ensure that the Converge services are running. If they say Stopped, click Start.
      service running.
    4. Click Refresh Devices and allow Commerce Web Services several minutes to detect the device.
      refresh devices.
    5. When Commerce Web Services is ready, you should see the Port and Card Reader name automatically populate into the Configuration section. You are ready to test a transaction.
      converge troubleshooting port-card reader.

 

If you do not see your device listed, follow the hardware troubleshooting steps in the next section.

 

Go to Article Navigation

 

Hardware Troubleshooting Steps

  1. Check your Device Manager, you should see your device listed there. If you do not, proceed with the following steps.
    converge troubleshooting ingenico.
  2. Check to make sure that there are no loose wires and check the power cord, magic box, and USB cables. Ensure the magic box is pressed firmly into the back of the Ingenico device.
  3. Click Refresh Devices in Commerce Web Services to see if the device is recognized.
    refresh devices.
  4. Try a different USB Port. If connected through a dock or hub, connect the device directly to a port on the computer.
    • Click Refresh Devices in Commerce Web Services to see if the device is recognized.
  5. Try a different USB cable.
    • Click Refresh Devices in Commerce Web Services to see if the device is recognized.
  6. Restart the computer. Be sure to run ConvergeConnect with administrator privileges. Make sure that the Converge Service and CWS are both running, then:
    • Click Refresh Devices in Commerce Web Services to see if the device is recognized.

 

Go to Article Navigation

 

Additional Troubleshooting

  1. Make sure you do not have CivicPlus's IP (internet protocol) addresses whitelisted on your Converge terminals for retail. The IPs only need to be whitelisted for the internet and when using the Hosted Payment Pages. If you whitelist CivicPlus IPs, all your transactions will be blocked. This is because traffic from card-present transactions comes from the machine that originates the transaction (your local computer) and not from CivicPlus. 
  2. Make sure that EMV chip cards are enabled on your Converge terminal.
  3. Ensure that the appropriate card types are enabled on your Converge terminal.

 

If following the steps above did not help, reach out to your IT department, Elavon Converge support, or your payment terminal manufacturer.

 

Go to Article Navigation

Comments

Let us know what was helpful or not helpful about the article.

0 comments

Please sign in to leave a comment.