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.

B
Written by Beverlie Sopiep
Updated over 2 weeks 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 ensure 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 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

m[mid].oltp.pxsplatform.com

HTTPS
(Inbound + Outbound)

443

PXS Merchant Portal

m[mid].merchant.pxservice.com

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

m[mid].api.pxslab.com

HTTPS
(Inbound + Outbound)

443

European Union Servers

Site/App

URL

Primary IP

Backup IP

Connection

Port(s)

POS Transactional Server

m[mid].eu.oltp.pxsplatform.com

HTTPS
(Inbound + Outbound)

443

PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

REST Integrations

m[mid].eu.api.pxsplatform.com

HTTPS
(Inbound + Outbound)

443

My Guest Account

[client].eu.myguestaccount.com

m[mid].eu.myguestaccout.com

HTTPS
(Inbound + Outbound)

443

Test Environment:
PXS Merchant Portal

HTTPS
(Inbound + Outbound)

443

Test Environment:
POS Transactional Server

m[mid].train.eu.oltp.pxsplatform.com

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 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 POS-Specific Allowlisting Specifications

Aloha POS

Applications (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

POSitouch

Ports (BOH & Terminals)

Allowlist these ports on both the BOH and terminals:

  • 5022

  • 5023

  • 5024

Micros RES 3700

Ports

Allowlist port 9000 on both the BOH and terminals.

Oracle Simphony

Ports

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

All Other POS Systems

Please work directly with support to discuss additional allowlist specifications for all other POS systems.

Did this answer your question?