In order for ROLLER Payments card terminals to process transactions there needs to be communication between your POS device, card terminal, and our payment acquirer Adyen. To enable this communication, your network needs to be configured to allow access to specific ports and addresses.
In this article:
- Configuring your network
- Configuring the terminal IP address
- Implement POS network best practices
- Wi-Fi recommendations
Configuring your network
If you need to whitelist IP addresses, add these domains to your firewall's whitelist.
Configure your firewall to allow outgoing HTTPS traffic from the IP addresses of your cash registers and terminals to:
Whitelisting should be based on the DNS name of these URLs. Your firewall should dynamically check for IP address updates, at least every 60 seconds.
Do not hard-code these IP addresses, as these can change over time.
Open the ports:
- tcp/443 to the internet.
tcp/8443 on your LAN.
Configuring the terminal IP address
There are two ways to assign an IP address to a terminal:
- Dynamic IP: Your DHCP server assigns an IP address to the terminal.
- Static IP: You enter the IP address and other configuration details manually on the terminal.
By default, DHCP is enabled on the payment terminal.
To configure a static terminal IP address:
- On the connected terminal, open the Admin menu by pressing 9 and then Green and entering code 0166.
- Select Network and then, depending on your connection type:
Connection type Select Wired Ethernet Wireless WiFi > select your Wi-Fi network > IP Settings.
- In IP Settings, clear the Use DHCP check box.
- Enter your network details. To type a period (.), press 1 twice. Enter the IP address, the Subnet mask, the Default gateway, the Preferred DNS, and the Alternate DNS.
The static IP address must be unique in the network and, if you have more than one terminal, ensure the static IP is unique for each terminal.
- Select Apply.
Implement POS network best practices
To connect your ROLLER Payments card terminals over Wi-Fi, your access point should support:
- WPA/WPA2-Enterprise encryption, or WPA/WPA2-Personal encryption.
2.4Ghz or 5Ghz frequencies.