By federal law, debit cards issued in the United States must support processing through at least two different payment networks:
- One global, "front-of-card" network: Visa, Mastercard, or Discover. These are also referred to as Signature networks.
- One or more domestic, "back-of-card" networks, collectively known as US Debit networks: Accel, Maestro USA, NYCE, PULSE, or STAR. These are also referred to as PINless Debit for online payments, and PIN Debit for in-person payments.
So the same debit transaction can be routed through the global network, or through a domestic US Debit
network. This creates competition in debit pricing and reduces payment costs.
You can take advantage of this by activating US Debit with Intelligent Payment Routing. For each eligible debit payment, we dynamically select the optimal route, in accordance with your preferred optimization strategy for prioritizing cost savings, prioritizing conversion rate uplift, or a balance between the two. From the shopper's perspective, nothing changes: they continue to use their existing cards, Apple Pay, or Google Pay.
Requirements
Before you begin, take into account the following requirements, limitations, and preparations.
| Requirement | Description |
|---|---|
| Integration type | An online payments integration, or an in-person payments integration including standalone terminals and mobile SDK integrations. |
| API credentials | To add payment methods using the Management API, your API credential must have the Management API—Payment methods read and write role. |
| Customer Area roles | To add payment methods in your Customer Area, you need the Change payment methods role. To enable Intelligent Payment Routing, you need the Merchant admin role or the Merchant manage Uplift optimize settings role. |
| Setup steps | To receive the payment method variant in standard payment webhooks, turn on Include Subvariant in the additional webhook settings. |
Intelligent Payment Routing
Intelligent Payment Routing is an Adyen feature that uses machine learning to automatically select the most cost-effective and reliable network for a transaction. This feature is part of the Optimize module of Adyen Uplift. Intelligent Payment Routing selects a network for each transaction based on cost, authorization rates, and network availability.
Activating US Debit adds domestic networks to the available routes. Intelligent Payment Routing then selects a route according to your optimization strategy:
| Optimization strategy | Effect |
|---|---|
| Balance conversion rates and costs | Weighs authorization rates and costs. This is the recommended strategy for most businesses. |
| Optimize conversion rates | Prioritizes the network most likely to authorize the payment, regardless of cost. |
| Optimize costs | Prioritizes the least expensive network while maintaining acceptable authorization rates. |
How US Debit routing with Intelligent Payment Routing works
You first need to activate US Debit by adding US Debit payment methods and enabling Intelligent Payment Routing. US Debit routing then follows this process:
- The shopper pays with a US-issued debit or prepaid card, directly or through a supported digital wallet.
- Adyen determines which networks can process the payment. This depends on the card, your active payment methods, and the payment flow.
- Intelligent Payment Routing evaluates the available routes using your optimization strategy, and selects a network.
- Adyen sends the payment to the selected network. The network appears in the payment response or webhook message, and in reports.
Considerations for in-person payments
For in-person payments, card application selection rules and PIN verification requirements affect whether Adyen can route a payment through US Debit.
Card application selection rules
Debit cards in the US have multiple applications (payment methods), and two Application Identifiers (AIDs): the Global AID and the Common Debit AID. To avoid asking shoppers to manually select one of the card's available applications on the payment terminal, we apply application selection rules to automatically determine the routing of transactions.
- A rule like Select Visa over US PIN debit prioritizes the Global AID and restricts routing to the global network.
- A rule that prioritizes the Common Debit AID allows routing through either a domestic network or the global network.
When you activate US Debit, payment terminals automatically prioritize the US Common Debit AID for US-issued debit cards.
PIN requirements and PIN bypass
The Common Debit AID typically requires PIN verification. To reduce checkout time, you can ask our Support Team to enable PIN bypass. Depending on your preference, the payment terminal then either does not prompt for a PIN, or prompts for a PIN and also shows an instruction for how to skip PIN entry.
If no PIN is entered, a payment can still be routed to a US Debit network if it allows PINless processing. Otherwise, Adyen uses the global network. If the US Debit network does not allow PINless processing and the terminal cannot obtain an online PIN (as is the case during an offline payment) Adyen also uses the global network.
Note that PIN bypass increases the risk of fraud with lost or stolen cards. The liability for related chargebacks can shift from the issuer to you. PIN bypass also reduces domestic routing options when the US Debit network does not allow PINless processing.
Activate US Debit
To set up US Debit payments:
-
Reach out to your Adyen contact to agree on the US Debit networks you want to use and the related pricing.
-
Add the US Debit payment methods to your merchant account or store, either in the Customer Area or through API calls. Select the tab for your preferred method.
-
To receive the payment method variant in standard payment webhooks, turn on Include Subvariant in the additional webhook settings.
-
In your Customer Area, enable intelligent payment routing:
- Go to Uplift > Uplift settings and select Optimize.
- Turn on Intelligent payment routing and select your preferred routing optimization strategy.
- Save the new settings.
-
If you accept Apple Pay or Google Pay, ask your Adyen contact to enable US Debit routing for these wallets. This is not enabled by default.
-
For in-person payments:
- Agree with your Adyen contact on PIN bypass and application selection preferences.
- Wait for the new terminal configuration to take effect. This happens automatically during the next maintenance call, or after manually starting a configuration update.
-
In your test environment, verify the integration:
- For online payments, use the US Debit test card numbers.
- For in-person payments, ask your Adyen contact for physical US Debit test cards. You can use these cards for test payments where you insert the card into the terminal. You cannot use them for contactless test payments.
-
Check the response and webhook values and reports to confirm that your integration recognizes the selected networks.
Analytics
You can monitor the performance of US Debit routing in the following ways:
- In your Customer Area, go to Uplift > Uplift overview to check the impact of intelligent payment routing on your authorization rates and costs.
- In reports, look for transactions with a payment method variant that indicates a US Debit network.
If an unexpectedly low percentage of eligible transactions is routed to a US Debit network, this can indicate an issue with the prioritization of payment methods on your account. Reach out to your Adyen contact or our Support Team for help.
US Debit in responses and webhooks
In payment responses and webhooks, the payment method variant identifies the US Debit network and, where applicable, the digital wallet. Your integration must recognize the payment method variant values for US Debit networks. Do not assume that every debit card payment uses its front-of-card network.
Online payments
In standard payment webhooks, paymentMethod identifies the payment method. With Include Subvariant turned on, additionalData.paymentMethodVariant identifies the payment method variant.
In-person payments
In a Terminal API integration, the Terminal API PaymentResponse.Response.AdditionalResponse contains paymentMethod and paymentMethodVariant. These parameters identify the network that processed the payment, regardless of the card entry method.
However, with offline payments, including store-and-forward payments, the terminal does not know where the payment will be routed. So the terminal treats the card as a generic common debit card, and can return uspindebit in the payment response. This value indicates a US Debit payment method was used, but not which one. Your integration must not map uspindebit to a specific domestic network.
Payment method variants
These payment method variants can appear in transaction data:
| Network | Online card payment | In-person card payment | Apple Pay | Google Pay |
|---|---|---|---|---|
| Accel | accel | accel | accel_applepay | accel_googlepay |
| Maestro USA | maestro_usa | maestro_usa | maestro_usa_applepay | maestro_usa_googlepay |
| NYCE | nyce | nyce | nyce_applepay | nyce_googlepay |
| PULSE | pulse_pinless | pulse | pulse_applepay | pulse_googlepay |
| STAR | star | star | star_applepay | star_googlepay |
| Undetermined | uspindebit Can occur for offline in-person payments. |
US Debit in reports
In the standard Adyen reports, US debit payments appear under the specific payment method variant.
Activating US Debit affects these reports and columns:
| Report | Columns |
|---|---|
| Settlement details report | Payment Method, Payment Method Variant |
| Payment accounting report | Payment Method, Payment Method Variant |
| Received payment details report | Payment Method, Payment Method Variant |
| Dispute transaction details report | Payment Method, CB Scheme Code, Dispute Reason, CB Reason Code |
The Payment Method Variant columns use the network and wallet values. Your reconciliation rules need to recognize these values as well as Visa, Mastercard, and Discover.
In your Customer Area, US Debit payments are identified by their network. Intelligent Payment Routing analytics show the effect of routing on authorization rates and costs.
Supported networks and features
Adyen supports the following US Debit networks:
| Network | Owner | Channel |
|---|---|---|
| Accel | Fiserv | Online and in-person payments |
| Maestro USA | Mastercard | Online and in-person payments |
| NYCE | FIS | Online and in-person payments |
| PULSE | Discover/Capital One | Online and in-person payments |
| STAR | Fiserv | Online and in-person payments |
The following table shows to what extent the above US Debit networks support specific payment features.
| Feature | Channel | Support |
|---|---|---|
| Settlement | Online, In‑person |
Sales day payout with a default payout delay of T+2, or pass-through payout. |
| Refund | Online, In‑person |
Referenced and unreferenced refunds. Monitor for webhook messages with eventCode REFUND_FAILED. It is possible that the US Debit network rejected the refund and that you need to compensate the shopper in another way. Success rates vary for unreferenced refunds, so we recommend referenced refunds. |
| Cancel | Online, In‑person |
For PULSE, there is a cancellation time limit of 24 hours. |
| Dispute defense | Online, In‑person |
Through your Customer Area or the Disputes API. |
| Network tokens | Online | Eligible Visa, Mastercard, and Discover network tokens can use domestic routes with Network Token Optimization enabled. |
| Apple Pay and Google Pay | Online, In‑person |
The debit cards linked to Apple Pay and Google Pay wallets can use domestic routes after Adyen enables this feature. Shoppers continue to use the wallet as usual. For online payments with these wallets, the liability for fraudulent purchases lies with you, and does not shift to the card issuer. For wallet payments through Adyen payment terminals, this liability shifts to the issuer as usual. |
| 3D Secure | Online | Not supported by US Debit networks. Adyen routes 3D Secure-authenticated payments through the global network. |
| PIN bypass | In‑person | Optional. Can increase fraud risk, and reduce routing options if PINless processing is not allowed by the US Debit network. |
| Authorization adjustments | Online, In‑person |
Will be supported on US Debit in 2027. |