Home › Knowledgebase › KB-1605

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

  1. Confirm the affected PC is connected to the correct business Wi-Fi network.
  2. Ping the payment gateway domain to check the resolved IP address.
  3. Inspect the Windows hosts file for stale entries.
  4. Flush the DNS resolver cache.
  5. Restart the POS application and retest the payment gateway.

Detailed Instructions

1. Verify Network Connection

  1. Select the network icon in the Windows taskbar.
  2. Ensure the PC is connected to the business network and not a guest or mobile hotspot.
  3. Open a web browser and navigate to a public website to confirm general internet access.

2. Test Connectivity to the Payment Gateway

  1. Press Windows Key + R to open the Run dialog.
  2. Type cmd and press Enter.
  3. In the Command Prompt, type ping [payment-gateway-domain], replacing the placeholder with your provider's domain, then press Enter.
  4. Note the IP address returned. If it resolves to a local address such as 127.0.0.1 or an unfamiliar internal IP, the hosts file is likely redirecting traffic.

3. Inspect the Windows Hosts File

  1. Press Windows Key, type Notepad, right-click Notepad, and select Run as administrator.
  2. In Notepad, select File > Open.
  3. Navigate to C:\Windows\System32\drivers\etc.
  4. Change the file type filter from Text Documents (*.txt) to All Files (*.*).
  5. Select the file named hosts and click Open.
  6. Look for any lines containing the payment gateway domain or your payment processor's name.
  7. 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

  1. Open Command Prompt as administrator.
  2. Type ipconfig /flushdns and press Enter.
  3. Wait for the confirmation message stating the DNS resolver cache was successfully flushed.

5. Restart the POS Application

  1. Close the point-of-sale application completely.
  2. Reopen the application and log back in.
  3. Attempt a test transaction or gateway connection to verify the timeout is resolved.

Troubleshooting

If the issue persists after clearing the hosts file

If multiple devices cannot reach the payment gateway

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