Skip to main content

Payments Failing on Your Network? Allowlist Adyen Domains (IT Setup Guide)

If your firewall blocks non-US traffic, PbN payment terminals and card entry can fail. Share these steps with your IT team.

Written by Alyssa Elso

Adyen, our payment processing partner, processes PbN Payments. Adyen is headquartered in the Netherlands, and some of its services are hosted outside the United States.

Many practice IT teams configure their firewall to block internet traffic to or from locations outside the US (often called geo-blocking). When this is in place, your payment terminals and computers cannot reach Adyen, and payments fail. To fix this, your IT team needs to whitelist Adyen's domains so that traffic to Adyen is permitted, even while other non-US traffic remains blocked.

Share this article with your IT team or network provider. Make the changes below on your practice's firewall or network filter, not inside PbN.

Signs Your Network Is Blocking Adyen

Your practice may be affected if you see any of the following:

  • The payment terminal shows as offline or cannot connect, even though it has an internet connection

  • Terminal transactions time out or fail without a card decline reason

  • The card entry fields do not load when charging a patient from a computer on the practice network

  • Payments work from a different network (for example, a mobile hotspot) but fail on the practice network

Domains to Whitelist

Configure your firewall to allow outbound HTTPS traffic from your payment terminals and the computers your team uses to take payments to the following domains, including all of their subdomains:

Domain

What it covers

*.adyen.com

All Adyen subdomains, including terminal, payment, and configuration services

*.adyenpayments.com

All Adyen payments subdomains

Allowlist by domain name, not by IP address. Adyen's IP addresses can change over time, and Adyen does not publish a list. Hard-coding IP addresses will break payments when they change. Your firewall should re-check the IP addresses behind these domains at least every 60 seconds.

The wildcard (*) matters. Allowlisting only adyen.com without the wildcard will not cover the subdomains that terminals and payment pages actually connect to.

If Your Network Uses Geo-Blocking

You do not need to allow all traffic from Europe or any other region. Instead, add an exception for the two Adyen domains above so that they bypass your geo-blocking rules. All other non-US traffic can stay blocked.

Which Devices Need Access

  • Payment terminals — every terminal at every location, whether connected by Ethernet or Wi-Fi

  • Practice computers — any computer staff use to charge patients, collect payments, or manage payment settings in PbN

If your practice has more than one location or network, apply the allowlist at each one.

Confirming the Change Worked

  1. After your IT team applies the allowlist, restart the payment terminal.

  2. Confirm the terminal connects and shows as online.

  3. Run a small test transaction on the terminal.

  4. From a practice computer, open the Charge Patient window and confirm the card entry fields load.

If payments still fail after the allowlist is in place, contact PbN Support and let us know which device is affected and what error you see.

Quick Reference for IT Teams

Copy and share the following with your IT team or network provider:

  • Allow outbound HTTPS to *.adyen.com and *.adyenpayments.com (including all subdomains)

  • Allowlist by DNS name, not IP address; re-resolve IPs at least every 60 seconds

  • If geo-blocking is enabled, exempt these two domains from it

  • Apply to all payment terminals and all computers used to take payments, at every location

Frequently Asked Questions

  1. Why does a US practice need to allow traffic outside the US?
    Adyen is a global payment processor headquartered in the Netherlands. Some of the services your terminals and payment pages rely on are hosted outside the US. Blocking those locations blocks the payments themselves.

  2. Do we need to open all European traffic?
    No. Only the two Adyen domains need to be allowed. Everything else can remain blocked.

  3. Can we allowlist Adyen's IP addresses instead?
    No. Adyen does not publish its IP addresses and they change over time. Allowlisting by domain is the only reliable method.

  4. Does this affect patients paying from home?
    No. This only applies to devices on your practice's network. Patients paying through a payment link on their own internet connection are not affected by your practice's firewall.

Did this answer your question?