TSYS is a legacy Datacap-family integration kept for existing merchants. It is configured with the Other EMV processor option plus two device overrides — EMV_VX805_TSYS and VX805XPI_CTLS — on top of the standard VX 805 + NETePay Windows setup.

This is a legacy integration. PHP Point Of Sale no longer offers new merchant enrollments with TSYS (now part of Global Payments); new stores should use PHP POS Payments — see choosing a payment processor. The setup below remains valid for existing TSYS merchants.

TSYS 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. The one thing that makes TSYS different from the other Datacap processors is the processor dropdown: TSYS does not have its own named entry, so you select Other EMV processor and identify the terminal with two device override strings. The VX 805 hardware comes from TSYS, not from the PHP Point Of Sale hardware store.

Install the bundled software

1. Download the TSYS installer bundle that matches your NETePay license — there was a purchase bundle and a rental 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 TSYS. 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 TSYS'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 Other EMV processor — there is no TSYS entry in the dropdown; the overrides in the next step are what make it TSYS.
4. Enter EMV_VX805_TSYS in the EMV Device Override field and VX805XPI_CTLS in the Non EMV Device Override field, exactly as written.
5. Enter the EMV Merchant ID / Terminal ID exactly as shown at the top of your setup sheet.
6. Leave COM port at its default of 9 and Listener port at its default of 3333 unless your installer told you otherwise.
7. Leave Net E-Pay Server empty unless NETePay runs on a different machine than this register.
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 Other EMV processor.
• EMV Device Override — EMV_VX805_TSYS.
• Non EMV Device Override — VX805XPI_CTLS.
• 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.
• Integrated Gift Cards — only if your TSYS 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 EMV Device Override / Non EMV Device Override columns (useful when registers have different hardware), 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 TSYS still supported? Existing TSYS merchants can keep processing through the Other EMV processor option, but new enrollments are no longer offered. New stores should use PHP POS Payments.

Why isn't TSYS in the processor dropdown? TSYS rides the generic Datacap path. Selecting Other EMV processor and entering the two override strings (EMV_VX805_TSYS and VX805XPI_CTLS) is the supported way to configure it.

Chip cards work but tap does not (or vice versa). The two overrides split the duties: EMV_VX805_TSYS handles EMV chip and VX805XPI_CTLS handles the non-EMV/contactless path. Re-check both fields for typos — they must match exactly.

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 TSYS'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.

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