Before You Start
Before you get started, here are a couple important terms to know:
Credential – File generated by the Paytronix system that is unique to each location running a Paytronix Controller. It provides server authentication between the Paytronix Controller and the Paytronix servers.
MAC Address - a hardware identification number that uniquely identifies each device on a network.
Credentials are necessary for POS integrations that use a Paytronix Controller (PCX). The credential is authenticated against our servers (PXS) and allows the BOH server to relay communications between the store-level POS and PX transactional servers (PXS). Credential creation is the final PX-based step of store creation and must be done after every server replacement, as well. You will need specific permissions to make/edit credentials; please reach out to your Paytronix user admin to be granted these permissions.
The credential will reference the security agent of the store, and is the MAC address of the external NIC. You will find this through a command run on your BOH terminal where you are installing the Controller: (Windows Start menu) > type “cmd” to launch Command Prompt > type “ipconfig/all” > find the physical address (a series of 6 pairs). This is the MAC address.
You will insert this MAC address under the Label and Hardware ID sections of a new credential.
Please Note: Credentials are only needed for POS systems that have a Back of House Server (Aloha, Micros 3700, Simphony, POSitouch, etc). POS Systems that are cloud based and connect to Paytronix via our API do not need credentials (Toast, Revel, etc).
Creating a New Credential
To create a new credential:
1. In the PXS Merchant (https://www.pxsweb.com/merchant/home.srv) in Quick Find type in credential and select Credentials.
2. Click Create Credential.
3. In the Stores Agent drop-down select the store you are adding the credential to.
4. Under Hardware ID Type, select MAC address and then input the MAC address under Hardware ID and submit. If successful, the credential will update with a choice to download it and insert manually into C:\Paytronix\Credentials. This process is done automatically when installing the Controller, and is not always necessary.
5. Click Submit. Note: Each credential is unique, and therefore MACs cannot be duplicates.
After creating the credential, there will be an option to directly download it.
If needed, the credential file can be inserted into the C:\Paytronix\credentials directory. It will be titled similarly to cred_30_13142_13840_22134.txt.
You are now set to install the Paytronix Controller service, found at paytronix.com/support. For directions on installation, upgrading, or troubleshooting, please review the Paytronix Controller (PXC) Installation & Upgrade Guide and Troubleshooting Paytronix Controller (PXC) Installation & Upgrade articles.