{"title":"United States: US Debit with Intelligent Payment Routing","category":"default","creationDate":1795003019,"content":"<p>By federal law, debit cards issued in the United States must support processing through at least two different payment networks:<\/p>\n<ul>\n<li>One global, \"front-of-card\" network: Visa, Mastercard, or Discover. These are also referred to as Signature networks.<\/li>\n<li>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.<\/li>\n<\/ul>\n<p>So the same debit transaction can be routed through the global network, or through a domestic US Debit<br \/>\nnetwork. This creates competition in debit pricing and reduces payment costs.<\/p>\n<p>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.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">An <a href=\"\/online-payments\/build-your-integration\">online payments integration<\/a>, or an <a href=\"\/point-of-sale\/design-your-integration\">in-person payments integration<\/a> including standalone terminals and mobile SDK integrations.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/development-resources\/api-credentials\/\">API credentials<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">To add payment methods using the Management API, your API credential must have the <strong>Management API\u2014Payment methods read and write<\/strong> role.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/account\/user-roles\">Customer Area roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">To add payment methods in your Customer Area, you need the <strong>Change payment methods<\/strong> role. <br>To enable Intelligent Payment Routing, you need the <strong>Merchant admin<\/strong> role or the <strong>Merchant manage Uplift optimize settings<\/strong> role.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">To receive the payment method variant in standard payment webhooks, turn on <strong>Include Subvariant<\/strong> in the <a href=\"\/development-resources\/webhooks\/additional-settings\">additional webhook settings<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"routing\">Intelligent Payment Routing<\/h2>\n<p>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 <a href=\"\/uplift\">Adyen Uplift<\/a>. Intelligent Payment Routing selects a network for each transaction based on cost, authorization rates, and network availability.<\/p>\n<p>Activating US Debit adds domestic networks to the available routes. Intelligent Payment Routing then selects a route according to your optimization strategy:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Optimization strategy<\/th>\n<th style=\"text-align: left;\">Effect<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Balance conversion rates and costs<\/td>\n<td style=\"text-align: left;\">Weighs authorization rates and costs. This is the recommended strategy for most businesses.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Optimize conversion rates<\/td>\n<td style=\"text-align: left;\">Prioritizes the network most likely to authorize the payment, regardless of cost.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Optimize costs<\/td>\n<td style=\"text-align: left;\">Prioritizes the least expensive network while maintaining acceptable authorization rates.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"how-us-debit-routing-works\">How US Debit routing with Intelligent Payment Routing works<\/h2>\n<p>You first need to <a href=\"#activate-us-debit\">activate US Debit<\/a> by adding US Debit payment methods and enabling Intelligent Payment Routing. US Debit routing then follows this process:<\/p>\n<ol>\n<li>The shopper pays with a US-issued debit or prepaid card, directly or through a supported digital wallet.<\/li>\n<li>Adyen determines which networks can process the payment. This depends on the card, your active payment methods, and the payment flow.<\/li>\n<li>Intelligent Payment Routing evaluates the available routes using your optimization strategy, and selects a network.<\/li>\n<li>Adyen sends the payment to the selected network. The network appears in the payment response or webhook message, and in reports.<\/li>\n<\/ol>\n<h2>Considerations for in-person payments<\/h2>\n<p>For in-person payments, <a href=\"#aid\">card application selection rules<\/a> and <a href=\"#pin-bypass\">PIN verification requirements<\/a> affect whether Adyen can route a payment through US Debit.<\/p>\n<h3 id=\"aid\">Card application selection rules<\/h3>\n<p>Debit cards in the US have multiple <strong>applications<\/strong> (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 <a href=\"\/point-of-sale\/aid-selection-rules\">application selection rules<\/a> to automatically determine the routing of transactions.<\/p>\n<ul>\n<li>A rule like <em>Select Visa over US PIN debit<\/em> prioritizes the Global AID and restricts routing to the global network.<\/li>\n<li>A rule that prioritizes the Common Debit AID allows routing through either a domestic network or the global network.<\/li>\n<\/ul>\n<p>When you activate US Debit, payment terminals automatically prioritize the US Common Debit AID for US-issued debit cards.<\/p>\n<h3 id=\"pin-bypass\">PIN requirements and PIN bypass<\/h3>\n<p>The Common Debit AID typically requires PIN verification. To reduce checkout time, you can ask our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable <a href=\"\/point-of-sale\/cardholder-verification-methods#pin-bypass\">PIN bypass<\/a>. 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.<\/p>\n<p>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.<\/p>\n<p>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.<\/p>\n<h2>Activate US Debit<\/h2>\n<p>To set up US Debit payments:<\/p>\n<ol>\n<li>\n<p>Reach out to your Adyen contact to agree on the US Debit networks you want to use and the related pricing.<\/p>\n<\/li>\n<li>\n<p>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.<\/p>\n\n<div id=\"tablwyU3\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;In your &lt;a href=\\&quot;https:\/\/ca-test.adyen.com\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\/a&gt;, switch to your merchant account or store.&lt;\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Payments&lt;\/strong&gt; &amp;gt; &lt;strong&gt;Payment methods&lt;\/strong&gt; and select &lt;strong&gt;Request payment methods&lt;\/strong&gt;.&lt;\/li&gt;\\n&lt;li&gt;Use the dropdown lists to filter payment methods by location and type.&lt;\/li&gt;\\n&lt;li&gt;Select the US Debit payment methods that you agreed on with your Adyen contact.&lt;\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Add&lt;\/strong&gt; and apply the payment methods to &lt;strong&gt;This merchant account&lt;\/strong&gt; or a &lt;strong&gt;Store&lt;\/strong&gt;. If you are a Platform, apply the payment methods to your user&#039;s &lt;strong&gt;Store&lt;\/strong&gt;.&lt;\/li&gt;\\n&lt;li&gt;If prompted, fill in the required information.&lt;\/li&gt;\\n&lt;li&gt;Review what you entered and select &lt;strong&gt;Submit request&lt;\/strong&gt;.&lt;\/li&gt;\\n&lt;\/ol&gt;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;Check that the payment methods are active before you test.&lt;\/p&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;customer_area_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;For each US Debit payment method, send a POST  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/paymentMethodSettings\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/merchants\/{merchantId}\/paymentMethodSettings&lt;\/a&gt; request specifying your merchant account ID in the path, and the following parameters in the request body:&lt;\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Parameter&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\/th&gt;\\n&lt;\/tr&gt;\\n&lt;\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;type&lt;\/code&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\/media\/732127089c689593ccb0331d565e5773bed94e60145cae96672212374facb8c6.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \/&gt;&lt;\/span&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The US Debit network you want to add. Use one of the following values: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;accel&lt;\/strong&gt;&lt;\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;maestro_usa&lt;\/strong&gt;&lt;\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;nyce&lt;\/strong&gt;&lt;\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;pulse&lt;\/strong&gt;&lt;\/span&gt;, or &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;star&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;type.processingType&lt;\/code&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The type of transactions you plan to make with the payment method specified in &lt;code&gt;type&lt;\/code&gt;. Our recommendation is to not include this field. We then set up the payment method to process all transaction types. &lt;div class=\\&quot;sc-notice note\\&quot;&gt;&lt;div&gt;This field will be deprecated. If applicable, update your code to &lt;strong&gt;stop sending this field&lt;\/strong&gt;.&lt;\/div&gt;&lt;\/div&gt; Allowed values: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;pos&lt;\/strong&gt;&lt;\/span&gt; for in-person payments; SALE processing mode only.&lt;\/li&gt; &lt;li markdown=\\&quot;1\\&quot;&gt;&lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;billpay&lt;\/strong&gt;&lt;\/span&gt; for payments with &lt;code&gt;recurringProcessingModel&lt;\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;Subscription&lt;\/strong&gt;&lt;\/span&gt;; SALE processing mode only.&lt;\/li&gt; &lt;li markdown=\\&quot;1\\&quot;&gt;&lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;ecom&lt;\/strong&gt;&lt;\/span&gt; for online payments, including payments with &lt;code&gt;recurringProcessingModel&lt;\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;CardOnFile&lt;\/strong&gt;&lt;\/span&gt; or &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;UnscheduledCardOnFile&lt;\/strong&gt;&lt;\/span&gt;; AUTH processing mode only.&lt;\/li&gt;&lt;\/ul&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;storeIds&lt;\/code&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Conditionally required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Conditionally required\\&quot; src=\\&quot;\/media\/e654d4104461d20836c817ee9d8f27faa0e45c1a8d08558f079561a50fc2797e.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \/&gt;&lt;\/span&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;An array with the unique store IDs of the stores that you want to add the payment method to. Include this parameter in the following cases: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;An Adyen for Platforms integration with a platforms model setup.&lt;\/li&gt; &lt;li markdown=\\&quot;1\\&quot;&gt;An in-person payments integration with an account structure that includes stores.&lt;\/li&gt;&lt;\/ul&gt;&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;\/tbody&gt;\\n&lt;\/table&gt;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;For US Debit payment methods you do not need to include the parameters &lt;code&gt;countries&lt;\/code&gt; and &lt;code&gt;currencies&lt;\/code&gt; because the values default to &lt;strong&gt;US&lt;\/strong&gt; and &lt;strong&gt;USD&lt;\/strong&gt; automatically.&lt;\/p&gt;\\n&lt;\/div&gt;\\n&lt;\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Check the response and confirm that the payment method is active before you test.&lt;br \/&gt;\\nThe response includes information about how payments using this payment method are captured:&lt;\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Response parameter&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\/th&gt;\\n&lt;\/tr&gt;\\n&lt;\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;networkProcessingMode&lt;\/code&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Indicates the processing flow for the payment method. Possible values: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;auth&lt;\/strong&gt;&lt;\/span&gt;: If you have not &lt;a href=\\&quot;\/online-payments\/capture#types-of-capture?target=_blank\\&quot;&gt;configured automatic capture&lt;\/a&gt; for the transaction, you must manually capture the funds.&lt;\/li&gt; &lt;li markdown=\\&quot;1\\&quot;&gt;&lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;sale&lt;\/strong&gt;&lt;\/span&gt;: You do not need to separately capture the funds, because capture happens automatically as part of the transaction, together with authorization.&lt;\/li&gt;&lt;\/ul&gt;&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;\/tbody&gt;\\n&lt;\/table&gt;\\n&lt;\/li&gt;\\n&lt;\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;api_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>To receive the payment method variant in standard payment webhooks, turn on <strong>Include Subvariant<\/strong> in the <a href=\"\/development-resources\/webhooks\/additional-settings\" target=\"_blank\">additional webhook settings<\/a>.<\/p>\n<\/li>\n<li>\n<p>In your Customer Area, enable intelligent payment routing:<\/p>\n<ol>\n<li>Go to <strong>Uplift<\/strong> &gt; <strong>Uplift settings<\/strong> and select <strong>Optimize<\/strong>.<\/li>\n<li>Turn on <strong>Intelligent payment routing<\/strong> and select your preferred <a href=\"#routing\">routing optimization strategy<\/a>.<\/li>\n<li>Save the new settings.<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>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.<\/p>\n<\/li>\n<li>\n<p>For in-person payments:<\/p>\n<ul>\n<li>Agree with your Adyen contact on PIN bypass and application selection preferences.<\/li>\n<li>Wait for the new terminal configuration to take effect. This happens automatically during the next <a href=\"\/point-of-sale\/managing-terminals\/maintain-performance#maintenance-calls\">maintenance call<\/a>, or after manually starting a configuration update.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>In your test environment, verify the integration:<\/p>\n<ul>\n<li>For <strong>online payments<\/strong>, use the <a href=\"\/development-resources\/test-cards-and-credentials\/test-card-numbers#us-debit\">US Debit test card numbers<\/a>.<\/li>\n<li>For <strong>in-person payments<\/strong>, 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.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Check the <a href=\"#us-debit-responses\">response and webhook values<\/a> and <a href=\"#us-debit-reporting\">reports<\/a> to confirm that your integration recognizes the selected networks.<\/p>\n<\/li>\n<\/ol>\n<h2>Analytics<\/h2>\n<p>You can monitor the performance of US Debit routing in the following ways:<\/p>\n<ul>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, go to <strong>Uplift<\/strong> &gt; <strong>Uplift overview<\/strong> to check the impact of intelligent payment routing on your authorization rates and costs.<\/li>\n<li>In reports, look for transactions with a <a href=\"#payment-method-variants\">payment method variant<\/a> that indicates a US Debit network.<\/li>\n<\/ul>\n<p>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 <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> for help.<\/p>\n<h2 id=\"us-debit-responses\">US Debit in responses and webhooks<\/h2>\n<p>In payment responses and webhooks, the <strong>payment method variant<\/strong> 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.<\/p>\n<h3>Online payments<\/h3>\n<p>In standard payment webhooks, <code>paymentMethod<\/code> identifies the payment method. With <strong>Include Subvariant<\/strong> turned on, <code>additionalData.paymentMethodVariant<\/code> identifies the payment method variant.<\/p>\n<h3>In-person payments<\/h3>\n<p>In a Terminal API integration, the Terminal API <code>PaymentResponse.Response.AdditionalResponse<\/code> contains <code>paymentMethod<\/code> and <code>paymentMethodVariant<\/code>. These parameters identify the network that processed the payment, regardless of the card entry method.<\/p>\n<p>However, with <a href=\"\/point-of-sale\/offline-payment\">offline payments<\/a>, 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 <span translate=\"no\"><strong>uspindebit<\/strong><\/span> in the payment response. This value indicates a US Debit payment method was used, but not which one. Your integration must not map <span translate=\"no\"><strong>uspindebit<\/strong><\/span> to a specific domestic network.<\/p>\n<h3>Payment method variants<\/h3>\n<p>These <a href=\"\/development-resources\/paymentmethodvariant\">payment method variants<\/a> can appear in transaction data:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Network<\/th>\n<th style=\"text-align: left;\">Online card payment<\/th>\n<th style=\"text-align: left;\">In-person card payment<\/th>\n<th style=\"text-align: left;\">Apple Pay<\/th>\n<th style=\"text-align: left;\">Google Pay<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Accel<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>accel<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>accel<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>accel_applepay<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>accel_googlepay<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Maestro USA<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>maestro_usa<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>maestro_usa<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>maestro_usa_applepay<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>maestro_usa_googlepay<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">NYCE<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>nyce<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>nyce<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>nyce_applepay<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>nyce_googlepay<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">PULSE<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>pulse_pinless<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>pulse<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>pulse_applepay<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>pulse_googlepay<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">STAR<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>star<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>star<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>star_applepay<\/strong><\/span><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>star_googlepay<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Undetermined<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>uspindebit<\/strong><\/span><br>Can occur for offline in-person payments.<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\"><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"us-debit-reporting\">US Debit in reports<\/h2>\n<p>In the standard Adyen reports, US debit payments appear under the specific payment method variant.<\/p>\n<p>Activating US Debit affects these reports and columns:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Report<\/th>\n<th style=\"text-align: left;\">Columns<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><a href=\"\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report\">Settlement details report<\/a><\/td>\n<td style=\"text-align: left;\"><strong>Payment Method<\/strong>, <strong>Payment Method Variant<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"\/reporting\/payment-accounting-report\">Payment accounting report<\/a><\/td>\n<td style=\"text-align: left;\"><strong>Payment Method<\/strong>, <strong>Payment Method Variant<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"\/reporting\/received-payment-details-report\">Received payment details report<\/a><\/td>\n<td style=\"text-align: left;\"><strong>Payment Method<\/strong>, <strong>Payment Method Variant<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"\/reporting\/disputed-transactions\">Dispute transaction details report<\/a><\/td>\n<td style=\"text-align: left;\"><strong>Payment Method<\/strong>, <strong>CB Scheme Code<\/strong>, <strong>Dispute Reason<\/strong>, <strong>CB Reason Code<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The Payment Method Variant columns use the <a href=\"#payment-method-variants\">network and wallet values<\/a>. Your reconciliation rules need to recognize these values as well as Visa, Mastercard, and Discover.<\/p>\n<p>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.<\/p>\n<h2>Supported networks and features<\/h2>\n<p>Adyen supports the following US Debit networks:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Network<\/th>\n<th style=\"text-align: left;\">Owner<\/th>\n<th style=\"text-align: left;\">Channel<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Accel<\/td>\n<td style=\"text-align: left;\">Fiserv<\/td>\n<td style=\"text-align: left;\">Online and in-person payments<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Maestro USA<\/td>\n<td style=\"text-align: left;\">Mastercard<\/td>\n<td style=\"text-align: left;\">Online and in-person payments<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">NYCE<\/td>\n<td style=\"text-align: left;\">FIS<\/td>\n<td style=\"text-align: left;\">Online and in-person payments<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">PULSE<\/td>\n<td style=\"text-align: left;\">Discover\/Capital One<\/td>\n<td style=\"text-align: left;\">Online and in-person payments<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">STAR<\/td>\n<td style=\"text-align: left;\">Fiserv<\/td>\n<td style=\"text-align: left;\">Online and in-person payments<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following table shows to what extent the above US Debit networks support specific payment features.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Feature<\/th>\n<th style=\"text-align: left;\">Channel<\/th>\n<th style=\"text-align: left;\">Support<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Settlement<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">Sales day payout with a default payout delay of T+2, or pass-through payout.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refund<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">Referenced and unreferenced refunds. <br>Monitor for webhook messages with <code>eventCode<\/code>  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Webhooks\/latest\/post\/REFUND_FAILED\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">REFUND_FAILED<\/a>. It is possible that the US Debit network rejected the refund and that you need to compensate the shopper in another way. <br>Success rates vary for unreferenced refunds, so we recommend referenced refunds.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">For PULSE, there is a cancellation time limit of 24 hours.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Dispute defense<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">Through your Customer Area or the Disputes API.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Network tokens<\/td>\n<td style=\"text-align: left;\">Online<\/td>\n<td style=\"text-align: left;\">Eligible Visa, Mastercard, and Discover network tokens can use domestic routes with <a href=\"\/online-payments\/network-tokenization\/\">Network Token Optimization<\/a> enabled.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Apple Pay and Google Pay<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">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.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">3D Secure<\/td>\n<td style=\"text-align: left;\">Online<\/td>\n<td style=\"text-align: left;\">Not supported by US Debit networks. Adyen routes 3D Secure-authenticated payments through the global network.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">PIN bypass<\/td>\n<td style=\"text-align: left;\">In&#8209;person<\/td>\n<td style=\"text-align: left;\">Optional. Can increase fraud risk, and reduce routing options if PINless processing is not allowed by the US Debit network.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Authorization adjustments<\/td>\n<td style=\"text-align: left;\">Online,<br>In&#8209;person<\/td>\n<td style=\"text-align: left;\">Will be supported on US Debit in 2027.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/payment-methods\/cards\"\n                        target=\"_self\"\n                        >\n                    Cards for online payments\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\"\n                        target=\"_self\"\n                        >\n                    Payment methods for in-person payments\n                <\/a><\/li><li><a href=\"\/development-resources\/test-cards-and-credentials\/test-card-numbers#us-debit\"\n                        target=\"_self\"\n                        >\n                    US Debit test card numbers\n                <\/a><\/li><li><a href=\"\/development-resources\/paymentmethodvariant\"\n                        target=\"_self\"\n                        >\n                    Payment method variants\n                <\/a><\/li><li><a href=\"\/point-of-sale\/aid-selection-rules\"\n                        target=\"_self\"\n                        >\n                    Card application selection and routing\n                <\/a><\/li><li><a href=\"\/online-payments\/network-tokenization#co-badged-in-us\"\n                        target=\"_self\"\n                        >\n                    Co-badged network tokens in the US\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/industries\/markets\/us-debit","articleFields":{"description":"Understand Adyen's US Debit with Intelligent Payment Routing offering.","type":"page"},"algolia":{"url":"https:\/\/docs.adyen.com\/industries\/markets\/us-debit","title":"United States: US Debit with Intelligent Payment Routing","content":"By federal law, debit cards issued in the United States must support processing through at least two different payment networks:\n\nOne global, \"front-of-card\" network: Visa, Mastercard, or Discover. These are also referred to as Signature networks.\nOne 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.\n\nSo the same debit transaction can be routed through the global network, or through a domestic US Debit\nnetwork. This creates competition in debit pricing and reduces payment costs.\nYou 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.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAn online payments integration, or an in-person payments integration including standalone terminals and mobile SDK integrations.\n\n\nAPI credentials\nTo add payment methods using the Management API, your API credential must have the Management API\u2014Payment methods read and write role.\n\n\nCustomer Area roles\nTo 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.\n\n\nSetup steps\nTo receive the payment method variant in standard payment webhooks, turn on Include Subvariant in the additional webhook settings.\n\n\n\nIntelligent Payment Routing\nIntelligent 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.\nActivating US Debit adds domestic networks to the available routes. Intelligent Payment Routing then selects a route according to your optimization strategy:\n\n\n\nOptimization strategy\nEffect\n\n\n\n\nBalance conversion rates and costs\nWeighs authorization rates and costs. This is the recommended strategy for most businesses.\n\n\nOptimize conversion rates\nPrioritizes the network most likely to authorize the payment, regardless of cost.\n\n\nOptimize costs\nPrioritizes the least expensive network while maintaining acceptable authorization rates.\n\n\n\nHow US Debit routing with Intelligent Payment Routing works\nYou first need to activate US Debit by adding US Debit payment methods and enabling Intelligent Payment Routing. US Debit routing then follows this process:\n\nThe shopper pays with a US-issued debit or prepaid card, directly or through a supported digital wallet.\nAdyen determines which networks can process the payment. This depends on the card, your active payment methods, and the payment flow.\nIntelligent Payment Routing evaluates the available routes using your optimization strategy, and selects a network.\nAdyen sends the payment to the selected network. The network appears in the payment response or webhook message, and in reports.\n\nConsiderations for in-person payments\nFor in-person payments, card application selection rules and PIN verification requirements affect whether Adyen can route a payment through US Debit.\nCard application selection rules\nDebit 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.\n\nA rule like Select Visa over US PIN debit prioritizes the Global AID and restricts routing to the global network.\nA rule that prioritizes the Common Debit AID allows routing through either a domestic network or the global network.\n\nWhen you activate US Debit, payment terminals automatically prioritize the US Common Debit AID for US-issued debit cards.\nPIN requirements and PIN bypass\nThe 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.\nIf 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.\nNote 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.\nActivate US Debit\nTo set up US Debit payments:\n\n\nReach out to your Adyen contact to agree on the US Debit networks you want to use and the related pricing.\n\n\nAdd 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.\n\n\n    \n        \n        \n    \n\n\n\n\nTo receive the payment method variant in standard payment webhooks, turn on Include Subvariant in the additional webhook settings.\n\n\nIn your Customer Area, enable intelligent payment routing:\n\nGo to Uplift &gt; Uplift settings and select Optimize.\nTurn on Intelligent payment routing and select your preferred routing optimization strategy.\nSave the new settings.\n\n\n\nIf 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.\n\n\nFor in-person payments:\n\nAgree with your Adyen contact on PIN bypass and application selection preferences.\nWait for the new terminal configuration to take effect. This happens automatically during the next maintenance call, or after manually starting a configuration update.\n\n\n\nIn your test environment, verify the integration:\n\nFor online payments, use the US Debit test card numbers.\nFor 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.\n\n\n\nCheck the response and webhook values and reports to confirm that your integration recognizes the selected networks.\n\n\nAnalytics\nYou can monitor the performance of US Debit routing in the following ways:\n\nIn your Customer Area, go to Uplift &gt; Uplift overview to check the impact of intelligent payment routing on your authorization rates and costs.\nIn reports, look for transactions with a payment method variant that indicates a US Debit network.\n\nIf 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.\nUS Debit in responses and webhooks\nIn 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.\nOnline payments\nIn standard payment webhooks, paymentMethod identifies the payment method. With Include Subvariant turned on, additionalData.paymentMethodVariant identifies the payment method variant.\nIn-person payments\nIn 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.\nHowever, 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.\nPayment method variants\nThese payment method variants can appear in transaction data:\n\n\n\nNetwork\nOnline card payment\nIn-person card payment\nApple Pay\nGoogle Pay\n\n\n\n\nAccel\naccel\naccel\naccel_applepay\naccel_googlepay\n\n\nMaestro USA\nmaestro_usa\nmaestro_usa\nmaestro_usa_applepay\nmaestro_usa_googlepay\n\n\nNYCE\nnyce\nnyce\nnyce_applepay\nnyce_googlepay\n\n\nPULSE\npulse_pinless\npulse\npulse_applepay\npulse_googlepay\n\n\nSTAR\nstar\nstar\nstar_applepay\nstar_googlepay\n\n\nUndetermined\n\nuspindebitCan occur for offline in-person payments.\n\n\n\n\n\nUS Debit in reports\nIn the standard Adyen reports, US debit payments appear under the specific payment method variant.\nActivating US Debit affects these reports and columns:\n\n\n\nReport\nColumns\n\n\n\n\nSettlement details report\nPayment Method, Payment Method Variant\n\n\nPayment accounting report\nPayment Method, Payment Method Variant\n\n\nReceived payment details report\nPayment Method, Payment Method Variant\n\n\nDispute transaction details report\nPayment Method, CB Scheme Code, Dispute Reason, CB Reason Code\n\n\n\nThe 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.\nIn 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.\nSupported networks and features\nAdyen supports the following US Debit networks:\n\n\n\nNetwork\nOwner\nChannel\n\n\n\n\nAccel\nFiserv\nOnline and in-person payments\n\n\nMaestro USA\nMastercard\nOnline and in-person payments\n\n\nNYCE\nFIS\nOnline and in-person payments\n\n\nPULSE\nDiscover\/Capital One\nOnline and in-person payments\n\n\nSTAR\nFiserv\nOnline and in-person payments\n\n\n\nThe following table shows to what extent the above US Debit networks support specific payment features.\n\n\n\nFeature\nChannel\nSupport\n\n\n\n\nSettlement\nOnline,In&#8209;person\nSales day payout with a default payout delay of T+2, or pass-through payout.\n\n\nRefund\nOnline,In&#8209;person\nReferenced 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.\n\n\nCancel\nOnline,In&#8209;person\nFor PULSE, there is a cancellation time limit of 24 hours.\n\n\nDispute defense\nOnline,In&#8209;person\nThrough your Customer Area or the Disputes API.\n\n\nNetwork tokens\nOnline\nEligible Visa, Mastercard, and Discover network tokens can use domestic routes with Network Token Optimization enabled.\n\n\nApple Pay and Google Pay\nOnline,In&#8209;person\nThe 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.\n\n\n3D Secure\nOnline\nNot supported by US Debit networks. Adyen routes 3D Secure-authenticated payments through the global network.\n\n\nPIN bypass\nIn&#8209;person\nOptional. Can increase fraud risk, and reduce routing options if PINless processing is not allowed by the US Debit network.\n\n\nAuthorization adjustments\nOnline,In&#8209;person\nWill be supported on US Debit in 2027.\n\n\n\nSee also\n\n\n                    Cards for online payments\n                \n                    Payment methods for in-person payments\n                \n                    US Debit test card numbers\n                \n                    Payment method variants\n                \n                    Card application selection and routing\n                \n                    Co-badged network tokens in the US\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Industries and markets","lvl2":"Markets","lvl3":"United States: US Debit with Intelligent Payment Routing"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/industries","lvl2":"https:\/\/docs.adyen.com\/industries\/markets","lvl3":"\/industries\/markets\/us-debit"},"levels":4,"category":"","category_color":"","tags":["United","States:","Debit","Intelligent","Payment","Routing"]}}
