Skip to main content

Paytronix Security & Network Allowlist Guide

This article contains information about allowing the specific URLs, ports, hosts, services, installers, and applications required for communication between your technology and Paytronix systems.

Updated over 2 months ago

Overview

When Paytronix products are installed on a POS system, there’s back-and-forth communication between the POS terminals, the BOH (back-of-house) machine, and Paytronix systems (PXS). Your organization’s corporate information security team may use firewalls, security software, or other products and services designed to monitor networks, detect possible intrusions, and/or block suspicious network traffic. The best way to make sure communication between your POS system and Paytronix continues uninterrupted is to explicitly allow the specific URLs, ports, hosts, services, installers, and applications required for communication. If you think you are experiencing connectivity issues related to security or URL allowance, please work with your organization’s IT Security Team. We highly recommend that you meet with your organization’s IT Security Team before installing anything on the BOH machine so they can conduct an official security review.


Before You Start

At a minimum you will need admin access to the BOH machine and POS terminals. Depending on your corporate setup, you may need additional permissions or access. You may also be providing the information in this document to someone who manages firewall/security operations for your organization.

If you are able, we strongly recommend implementing a domain-based allowlist. Domain-based management allows all traffic to/from Paytronix, even if specific IP ranges change over time. It ensures that if Paytronix IP ranges change, your systems will still communicate with ours, without your needing to update security settings on your end. If you are not able to use a domain-based allowlist, you will need to make sure that your allowed IPs associated with Paytronix are always current.


Allowlisting Specifications - All POS Systems

Below are the URLs, IP addresses, ports, connections, services, applications, and installers you will need to allowlist on the BOH machine.

Cloudflare

Certain transactions are routed through Cloudflare for security, as such you should allowlist these IPs:
https://www.cloudflare.com/ips/

URLs, IPs, Connections, Ports

NOTE: For any links in the URL column, you will need to choose the correct Merchant when you click into the link.

North America Servers

Site/App

URL

Primary IP

Backup IP

Connection

Port(s)

POS Transactional Server

HTTPS
(Inbound + Outbound)

443

PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

REST Integrations

api.pxsweb.com (existing integrations)

m{mid}.api.pxsplatform.com

HTTPS
(Inbound + Outbound)

443

My Guest Account

HTTPS
(Inbound + Outbound)

443

Test Environment:
PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

Test Environment:
POS Transactional Server

HTTPS
(Inbound + Outbound)

443

1275

Test Environment:
REST Integrations

HTTPS
(Inbound + Outbound)

443

European Union Servers

Site/App

URL

Primary IP

Backup IP

Connection

Port(s)

POS Transactional Server

HTTPS
(Inbound + Outbound)

443

PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

REST Integrations

HTTPS
(Inbound + Outbound)

443

My Guest Account

HTTPS
(Inbound + Outbound)

443

Test Environment:
PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

Test Environment:
POS Transactional Server

HTTPS
(Inbound + Outbound)

443

Test Environment:
REST Integrations

m{mid}.train.eu.api.pxsplatform.com

HTTPS
(Inbound + Outbound)

443


Services & Applications

For the Paytronix Controller Service, you will need to allowlist one of the following applications:

Paytronix Controller (PXC)
C:\Paytronix\jre\bin\java.exe

Paytronix Daemon
C:\Paytronix\PxDaemonService.exe

Paytronix Upgrader
C:\Paytronix\PxUpgraderService.exe

Installers

PXC Installer: controller-installer-****.exe
Note: **** = version number of the installer

Additional Allowlist Specifications - Aloha Only

Applications (BOH & Terminals)

Order Entry Terminals

Paytronix for Aloha User Program:
C:\Paytronix\pxalohaui.exe

Ports (BOH & Terminals)

BOH

Port: 9055 Outgoing
Port: 9090 Incoming

Note: Port 9090 is the default port for Aloha Kitchen Interface (AKI). It is also the default port setting for Paytronix communication between Order Entry Terminals and the Paytronix Controller (PXC). If your organization uses AKI, or plans to, you will likely need to allowlist a different port for these communications. Which port? You can identify the correct port assigned to Paytronix communications by reviewing the installation config files, on the BOH machine. Check the BUSINESS_XML_PORT setting in the config files:

Sample config file text showing port setting.

Order Entry Terminals

Incoming and Outgoing: 9090

Note: If you set up a different port for these communications on the BOH machine, use the alternate port you are using on the BOH machine. You can also check the PXC_PORT setting in the pxalohaui.cfg config file for the correct port.

Incoming and Outgoing (Socket Listening): 9054
Incoming (Running Socket Status Thread): 9055

Additional Allowlist Specifications - POSitouch Only

Ports (BOH & Terminals)

Allowlist these ports on both the BOH and terminals:

  • 5022

  • 5023

  • 5024

Additional Allowlist Requirements -- Micros RES 3700 Only

Ports

Allowlist port 9000 on both the BOH and terminals.

Additional Allowlist Requirements -- Oracle Simphony Only

Ports

Allowlist port 22280 on both the CAPS server and service hosts (terminals).

Additional Allowlist Requirements -- All Other POS Systems

Please work directly with Paytronix Support to discuss additional allowlist specifications for all other POS systems. You can reach them at [email protected].

Did this answer your question?