Help Center

EVO Payments setup

Chris Muench
Chris Muench
  • Updated

EVO is a legacy Datacap-family integration kept for existing merchants: a VeriFone VX 805 pin pad driven by NETePay and the dsiPDCX / dsiEMVUS listener on a Windows PC. Global Gateway accounts additionally need the EMV_VX805_GLOBALPAY device override.

This is a legacy integration. PHP Point Of Sale no longer offers new merchant enrollments with EVO Payments; new stores should use PHP POS Payments — see choosing a payment processor. The EVO option remains in the software, so existing EVO merchants can keep processing with the setup below.

EVO uses the classic Datacap pattern: a VeriFone VX 805 pin pad connected to a Microsoft Windows PC that runs Datacap NETePay and the dsiPDCX / dsiEMVUS listener. That software must be running at all times — if it is closed, card processing stops. EVO accounts ride on one of two gateways, TSYS Gateway or Global Gateway, and each has its own installer bundle; your enrollment letter says which one you are on.

Contact numbers from the original enrollment material: 1-866-428-8903 (sales and service), 1-844-592-0892 (technical support). The VX 805 hardware comes from EVO directly, not from the PHP Point Of Sale hardware store.

Install the bundled software

  1. Download the installer bundle that matches your gateway — the EVO TSYS bundle or the EVO Global bundle. The links in old enrollment letters may be stale; ask support for the current download if yours no longer works.
  2. Double-click the executable and follow the on-screen prompts. The defaults, including the listener port of 3333, almost never need to be changed.
  3. Restart the computer when the installer finishes; the software launches automatically after the restart.

The bundle installs three components: the VX 805 device driver, the Datacap dsiPDCX / dsiEMVUS listener, and the Datacap NETePay client — the last two are what communicate with EVO. Your firewall must allow traffic on port 9000, and a working internet connection is required.

Set up NETePay

  1. Double-click the NETePay icon on the desktop if it is not already open.
  2. On first launch NETePay asks to obtain a serial number from Datacap's PSCS (Payment Systems Configuration Server). Click Obtain Serial Number — a 10-digit serial number is assigned. Click OK, then OK again on the dialog saying merchant parameters have not been retrieved yet.
  3. Choose Setup → Merchant Parameters, click Load New Parameters, then Yes.
  4. Click I have my DeploymentID and enter the Deployment ID from EVO's technical support (or from PHP Point Of Sale support), then click OK. If you never received one, contact support so the merchant parameters can be created on the PSCS server first.
  5. Verify the merchant demographic data. If it is wrong, click Cancel and repeat from step 3; if it is right, click Yes, This is the Correct Merchant.
  6. Click OK back through to the main status window. NETePay is ready to process.

Configure the location

  1. Go to Locations and click Edit next to the location that will take cards.
  2. In the Integrations section, check Enable Credit Card Processing.
  3. Set Credit Card Processor to EVO.
  4. Enter the EMV Merchant ID / Terminal ID exactly as shown at the top of your setup sheet.
  5. Leave COM port at its default of 9 and Listener port at its default of 3333 unless your installer told you otherwise.
  6. Leave Net E-Pay Server empty unless NETePay runs on a different machine than this register.
  7. Global Gateway accounts only: enter EMV_VX805_GLOBALPAY in the EMV Device Override field. TSYS Gateway accounts leave both override fields empty.
  8. Click Submit to save, then click Initialize credit card reader. Initialization can take one to two minutes; wait for the success message.

Editing locations requires the Locations module permission on your employee account — see permissions and templates. Integrated processing also requires the POS to be served over HTTPS.

Settings reference

  • Enable Credit Card Processing — master switch, off by default.
  • Credit Card Processor — set to EVO.
  • EMV Merchant ID / Terminal ID — from the setup sheet.
  • COM port — default 9.
  • Listener port — default 3333.
  • Net E-Pay Server — only if NETePay is on another machine.
  • EMV Device OverrideEMV_VX805_GLOBALPAY on Global Gateway; otherwise empty.
  • Non EMV Device Override — normally empty.
  • Integrated Gift Cards — only if your EVO account includes processor gift cards; see gift cards.
  • Use Integrated EBT — EBT through the terminal where the account supports it.
  • Disable Amount Confirmation when processing credit card — skips the confirmation prompt before the terminal wakes.
  • Per register in the Registers table: Terminal ID, Enable Tips, per-register device overrides, and Card Reader Actions.

After setup

Ring a small test sale and pay with Credit/Debit; the VX 805 wakes with the exact amount. Everyday card flows — chip, tap, swipe, tips, voids, refunds, unconfirmed-transaction recovery — are in taking card payments; the shared setup concepts are in setting up credit card processing.

Common questions

Is EVO still supported? Existing EVO merchants can keep processing — the option is still in the software — but new enrollments are no longer offered. New stores should use PHP POS Payments.

Which installer do I download — TSYS or Global? Whichever gateway your EVO account was boarded on; it is on your enrollment letter. If unsure, ask EVO technical support.

Initialization fails with "Unable to initialize device." Confirm NETePay and the listener are running, the COM port is 9, the listener port is 3333, port 9000 is open in the firewall, and the terminal has power. Then follow the VX 805 reset procedure in Worldpay, Vantiv & Mercury setup — it applies to every VX 805, including EVO's.

Cards suddenly stopped working mid-day. Almost always the Windows PC: NETePay or the listener was closed, or the PC slept or rebooted. Reopen NETePay, then click Initialize credit card reader on the location before the next sale.

I'm on Global Gateway and every card fails at the terminal. Check that EMV Device Override contains exactly EMV_VX805_GLOBALPAY — a typo or a missing override is the usual cause on Global Gateway accounts.

Can I run EVO on an iPad? No. This integration needs the Windows listener, so it is desktop-only. For tablets, look at PHP POS Payments.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.