Why Is The Payment Gateway Timing Out On The Front PC?
Summary
This guide helps you troubleshoot and resolve: Why Is The Payment Gateway Timing Out On The Front PC?. Follow the steps below to fix the issue.
Quick Tip: Need immediate assistance? 💻 Open a Ticket
Common Causes
Why Is The Payment Gateway Timing Out On The Front PC?
This article explains why a front-of-house POS PC may fail to connect to a payment gateway while other devices on the same network can access the payment processor portal without issue. In most cases, this is caused by an outdated entry in the Windows hosts file that redirects the payment provider's domain to a local or obsolete IP address, preventing the cloud handshake from completing.
Quick Fix Steps
- Confirm the affected PC is connected to the correct business Wi-Fi network.
- Ping the payment gateway domain to check the resolved IP address.
- Inspect the Windows
hostsfile for stale entries. - Flush the DNS resolver cache.
- Restart the POS application and retest the payment gateway.
Detailed Instructions
1. Verify Network Connection
- Select the network icon in the Windows taskbar.
- Ensure the PC is connected to the business network and not a guest or mobile hotspot.
- Open a web browser and navigate to a public website to confirm general internet access.
2. Test Connectivity to the Payment Gateway
- Press
Windows Key + Rto open the Run dialog. - Type
cmdand pressEnter. - In the Command Prompt, type
ping [payment-gateway-domain], replacing the placeholder with your provider's domain, then pressEnter. - Note the IP address returned. If it resolves to a local address such as
127.0.0.1or an unfamiliar internal IP, thehostsfile is likely redirecting traffic.
3. Inspect the Windows Hosts File
- Press
Windows Key, typeNotepad, right-click Notepad, and select Run as administrator. - In Notepad, select File > Open.
- Navigate to
C:\Windows\System32\drivers\etc. - Change the file type filter from Text Documents (*.txt) to All Files (*.*).
- Select the file named
hostsand click Open. - Look for any lines containing the payment gateway domain or your payment processor's name.
- Place a hash symbol (
#) at the start of any outdated line to comment it out, then select File > Save.
Editing the
hosts file requires administrator privileges. Incorrect changes can prevent access to websites and network resources. Only modify lines related to the payment gateway domain.4. Flush the DNS Resolver Cache
- Open Command Prompt as administrator.
- Type
ipconfig /flushdnsand pressEnter. - Wait for the confirmation message stating the DNS resolver cache was successfully flushed.
5. Restart the POS Application
- Close the point-of-sale application completely.
- Reopen the application and log back in.
- Attempt a test transaction or gateway connection to verify the timeout is resolved.
Troubleshooting
If the issue persists after clearing the hosts file
- Restart the front PC to ensure all network adapters refresh their settings.
- Confirm the router or firewall is not blocking outbound traffic on the ports required by the payment gateway.
- Test the payment gateway on a different device connected to the same network to isolate the issue to the front PC.
- Check whether any security software or endpoint protection is intercepting outbound HTTPS traffic.
If multiple devices cannot reach the payment gateway
- Power cycle the business router and modem.
- Contact your internet service provider to check for external outages.
- Contact your IT support team for further assistance.
Still Having Issues?
Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.
💻 Open a Ticket
💻 Open a Ticket