{"title":"PAN fallback for network tokens","category":"default","creationDate":1789729029,"content":"<p>If you <a href=\"\/online-payments\/network-tokenization#existing-network-tokens\">manage network tokens yourself<\/a> and are fully PCI compliant, you can include the underlying <a href=\"\/adyen-glossary#card-number-pan\">Primary Account Number<\/a> (PAN) in your payment request. When the issuer refuses the attempt with the network token, we can automatically retry the payment with the PAN. This helps you recover payments that would otherwise fail, without asking the shopper to enter their card details again.<\/p>\n<p>The PAN fallback is enabled by default, sending the PAN is optional. To use the fallback, include the PAN in your payment request. If you do not include the PAN, we process the payment with the network token only.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements and limitations.<\/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> where you <a href=\"\/online-payments\/network-tokenization#existing-network-tokens\">manage network tokens yourself<\/a>, that supports <a href=\"\/payment-methods\/cards\/\">card payments<\/a>, and uses Checkout API v69 or later.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/development-resources\/webhooks\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Subscribe to the Standard webhooks. To get data about the retry attempts we make, <a href=\"#collect-retry-attempt-data\">set up receiving retry attempt data<\/a> in your Customer Area.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li markdown=\"1\">The PAN fallback is only available in the live environment. You cannot test it in the test environment.<\/li><li markdown=\"1\">Not every refused payment leads to a retry with the PAN. Retries depend on the acquirer response code and on our optimization logic.<\/li><li markdown=\"1\">You cannot use 3D Secure for transactions with network tokens that you manage yourself.<\/li><li markdown=\"1\">You must be <a href=\"\/development-resources\/pci-dss-compliance-guide\">fully PCI compliant<\/a> to send the PAN in payment requests.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How the PAN fallback works<\/h2>\n<p>When your payment request contains both a network token and the underlying PAN, we can make two authorization attempts:<\/p>\n<ol>\n<li>You send a payment request that contains the network token and the underlying PAN.<\/li>\n<li>We always attempt the payment with the network token first. If it succeeds, the authorization completes using the network token.<\/li>\n<li>If the attempt is refused with a retryable response code, and our optimization logic determines that a retry can succeed, we trigger the PAN fallback.<\/li>\n<li>We send a second authorization attempt with the PAN. The shopper does not have to do anything.<\/li>\n<li>You get the result of each attempt in the payment response and in the <span translate=\"no\"><strong>AUTHORISATION<\/strong><\/span> webhook.<\/li>\n<\/ol>\n<p>If your payment request does not contain a PAN, we process the payment with the network token only, and your existing payment flow does not change.<\/p>\n<h2>Send a payment request with the PAN<\/h2>\n<p>To let us fall back to the PAN, send the network token and the underlying PAN in the same payment request.<\/p>\n<ol>\n<li>\n<p>From your server, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request. Include the parameters that you need to <a href=\"\/online-payments\/network-tokenization#make-the-initial-payment-with-a-network-token\">make a payment with a network token<\/a>, such as the <code>mpiData<\/code> object. To include the network token as well as the PAN, specify the following:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter name<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.type<\/code><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>networkToken<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.expiryMonth<\/code><\/td>\n<td style=\"text-align: left;\">The expiry month of the network token.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.expiryYear<\/code><\/td>\n<td style=\"text-align: left;\">The expiry year of the network token.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.cvc<\/code><\/td>\n<td style=\"text-align: left;\">Optional. The card verification code or security code.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.holderName<\/code><\/td>\n<td style=\"text-align: left;\">The name of the cardholder associated with the network token.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.number<\/code><\/td>\n<td style=\"text-align: left;\">The network token you get from the card network.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>paymentMethod.brand<\/code><\/td>\n<td style=\"text-align: left;\">Optional. For <a href=\"\/online-payments\/network-tokenization#co-badged-in-us\">co-badged network tokens in the US<\/a>, the card network that you want to route the payment to.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>secondaryPaymentMethod.number<\/code><\/td>\n<td style=\"text-align: left;\">The card number (PAN) associated with the network token.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>secondaryPaymentMethod.expiryMonth<\/code><\/td>\n<td style=\"text-align: left;\">The expiry month of the card.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>secondaryPaymentMethod.expiryYear<\/code><\/td>\n<td style=\"text-align: left;\">The expiry year of the card.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>secondaryPaymentMethod.holderName<\/code><\/td>\n<td style=\"text-align: left;\">The name of the cardholder associated with the card.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Excerpt of a \/payments request with PAN fallback data'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"merchantAccount\\\": \\\"YOUR_MERCHANT_ACCOUNT\\\",\\n   \\\"reference\\\": \\\"YOUR_PAYMENT_REFERENCE\\\",\\n   \\\"amount\\\": {\\n      \\\"currency\\\": \\\"USD\\\",\\n      \\\"value\\\": 1000\\n   },\\n   \\\"paymentMethod\\\": {\\n      \\\"type\\\": \\\"networkToken\\\",\\n      \\\"brand\\\": \\\"visa\\\",\\n      \\\"expiryMonth\\\": \\\"08\\\",\\n      \\\"expiryYear\\\": \\\"2028\\\",\\n      \\\"cvc\\\": \\\"737\\\",\\n      \\\"holderName\\\": \\\"CARDHOLDER_NAME\\\",\\n      \\\"number\\\": \\\"{hint:The network token.}666666xxxxxx6666{\\\/hint}\\\"\\n   },\\n   \\\"secondaryPaymentMethod\\\": {\\n      \\\"number\\\": \\\"{hint:The PAN associated with the network token.}4111111111111111{\\\/hint}\\\",\\n      \\\"expiryMonth\\\": \\\"08\\\",\\n      \\\"expiryYear\\\": \\\"2028\\\",\\n      \\\"holderName\\\": \\\"CARDHOLDER_NAME\\\"\\n   }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, check the <code>additionalData<\/code> object for <a href=\"#retry-attempt-data\">data about the attempts that we made<\/a>.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"collect-retry-attempt-data\">Collect retry attempt data<\/h2>\n<p>To find out which attempts we made for a payment, set up receiving retry attempt data in your payment responses and webhooks.<\/p>\n<p>To set up receiving retry attempt data:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Developers<\/strong> &gt; <strong>Additional data<\/strong>.<\/li>\n<li>In the <strong>Acquirer<\/strong> section, select <strong>Include the retry attempts<\/strong>.<\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"retry-attempt-data\">Retry attempt data<\/h2>\n<p>When you <a href=\"#collect-retry-attempt-data\">collect retry attempt data<\/a>, the <code>additionalData<\/code> object in your payment response contains a set of parameters for each attempt that we made. In the parameter names, <code>attemptN<\/code> is the number of the attempt: <code>attempt1<\/code> for the attempt with the network token, and <code>attempt2<\/code> for the attempt with the PAN.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter name<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>retry.attemptN.acquirer<\/code><\/td>\n<td style=\"text-align: left;\">The name of the acquirer that processed the attempt.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>retry.attemptN.acquirerAccount<\/code><\/td>\n<td style=\"text-align: left;\">The acquirer account that was used for the attempt.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>retry.attemptN.responseCode<\/code><\/td>\n<td style=\"text-align: left;\">The <a href=\"\/development-resources\/raw-acquirer-responses#visa-and-mastercard-raw-responses\">numeric acquirer response code<\/a> from the card network.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>retry.attemptN.rawResponse<\/code><\/td>\n<td style=\"text-align: left;\">The details of the <a href=\"\/development-resources\/raw-acquirer-responses\">raw unmodified response from the acquirer<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The <span translate=\"no\"><strong>AUTHORISATION<\/strong><\/span> webhook contains the same information as the <code>additionalData<\/code> object from your payment response.<\/p>\n<p>The following examples show the <code>additionalData<\/code> object for each possible outcome.<\/p>\n\n<div id=\"tabyLWk7\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Token refused, fallback authorized&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The attempt with the network token was refused, and the attempt with the PAN was authorized.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response with a successful PAN fallback&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;additionalData\\\\\\&quot;: {\\\\n      \\\\\\&quot;retry.attempt2.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.responseCode\\\\\\&quot;: \\\\\\&quot;00\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.rawResponse\\\\\\&quot;: \\\\\\&quot;Approved or completed successfully\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.responseCode\\\\\\&quot;: \\\\\\&quot;05\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.rawResponse\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;resultCode\\\\\\&quot;: \\\\\\&quot;Authorised\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Token authorized&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The attempt with the network token was authorized, so we did not use the PAN.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response with a successful first attempt&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;additionalData\\\\\\&quot;: {\\\\n      \\\\\\&quot;retry.attempt1.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.responseCode\\\\\\&quot;: \\\\\\&quot;00\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.rawResponse\\\\\\&quot;: \\\\\\&quot;Approved or completed successfully\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;resultCode\\\\\\&quot;: \\\\\\&quot;Authorised\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Token refused, no fallback&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The attempt with the network token was refused with a response code that we do not retry, or our optimization logic determined that a retry cannot succeed. There is no second attempt.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response with a refusal and no PAN fallback&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;additionalData\\\\\\&quot;: {\\\\n      \\\\\\&quot;retry.attempt1.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.responseCode\\\\\\&quot;: \\\\\\&quot;05\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.rawResponse\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;resultCode\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Token and fallback refused&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Both the attempt with the network token and the attempt with the PAN were refused.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response with two refused attempts&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;additionalData\\\\\\&quot;: {\\\\n      \\\\\\&quot;retry.attempt2.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.responseCode\\\\\\&quot;: \\\\\\&quot;05\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt2.rawResponse\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirer\\\\\\&quot;: \\\\\\&quot;Acquirer\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.acquirerAccount\\\\\\&quot;: \\\\\\&quot;AcquirerAccount\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.responseCode\\\\\\&quot;: \\\\\\&quot;05\\\\\\&quot;,\\\\n      \\\\\\&quot;retry.attempt1.rawResponse\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;resultCode\\\\\\&quot;: \\\\\\&quot;Refused\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/network-tokenization\"\n                        target=\"_self\"\n                        >\n                    Network tokenization\n                <\/a><\/li><li><a href=\"\/development-resources\/raw-acquirer-responses\"\n                        target=\"_self\"\n                        >\n                    Raw acquirer responses\n                <\/a><\/li><li><a href=\"\/development-resources\/webhooks\"\n                        target=\"_self\"\n                        >\n                    Webhooks\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/online-payments\/network-tokenization\/pan-fallback","articleFields":{"description":"Recover refused network token payments with an automatic retry on the underlying card number.","feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/online-payments\/network-tokenization\/pan-fallback","title":"PAN fallback for network tokens","content":"If you manage network tokens yourself and are fully PCI compliant, you can include the underlying Primary Account Number (PAN) in your payment request. When the issuer refuses the attempt with the network token, we can automatically retry the payment with the PAN. This helps you recover payments that would otherwise fail, without asking the shopper to enter their card details again.\nThe PAN fallback is enabled by default, sending the PAN is optional. To use the fallback, include the PAN in your payment request. If you do not include the PAN, we process the payment with the network token only.\nRequirements\nBefore you begin, take into account the following requirements and limitations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAn online payments integration where you manage network tokens yourself, that supports card payments, and uses Checkout API v69 or later.\n\n\nWebhooks\nSubscribe to the Standard webhooks. To get data about the retry attempts we make, set up receiving retry attempt data in your Customer Area.\n\n\nLimitations\nThe PAN fallback is only available in the live environment. You cannot test it in the test environment.Not every refused payment leads to a retry with the PAN. Retries depend on the acquirer response code and on our optimization logic.You cannot use 3D Secure for transactions with network tokens that you manage yourself.You must be fully PCI compliant to send the PAN in payment requests.\n\n\n\nHow the PAN fallback works\nWhen your payment request contains both a network token and the underlying PAN, we can make two authorization attempts:\n\nYou send a payment request that contains the network token and the underlying PAN.\nWe always attempt the payment with the network token first. If it succeeds, the authorization completes using the network token.\nIf the attempt is refused with a retryable response code, and our optimization logic determines that a retry can succeed, we trigger the PAN fallback.\nWe send a second authorization attempt with the PAN. The shopper does not have to do anything.\nYou get the result of each attempt in the payment response and in the AUTHORISATION webhook.\n\nIf your payment request does not contain a PAN, we process the payment with the network token only, and your existing payment flow does not change.\nSend a payment request with the PAN\nTo let us fall back to the PAN, send the network token and the underlying PAN in the same payment request.\n\n\nFrom your server, make a POST  \/payments request. Include the parameters that you need to make a payment with a network token, such as the mpiData object. To include the network token as well as the PAN, specify the following:\n\n\n\nParameter name\nDescription\n\n\n\n\npaymentMethod.type\nnetworkToken\n\n\npaymentMethod.expiryMonth\nThe expiry month of the network token.\n\n\npaymentMethod.expiryYear\nThe expiry year of the network token.\n\n\npaymentMethod.cvc\nOptional. The card verification code or security code.\n\n\npaymentMethod.holderName\nThe name of the cardholder associated with the network token.\n\n\npaymentMethod.number\nThe network token you get from the card network.\n\n\npaymentMethod.brand\nOptional. For co-badged network tokens in the US, the card network that you want to route the payment to.\n\n\nsecondaryPaymentMethod.number\nThe card number (PAN) associated with the network token.\n\n\nsecondaryPaymentMethod.expiryMonth\nThe expiry month of the card.\n\n\nsecondaryPaymentMethod.expiryYear\nThe expiry year of the card.\n\n\nsecondaryPaymentMethod.holderName\nThe name of the cardholder associated with the card.\n\n\n\n\n\n\n\n\nIn the response, check the additionalData object for data about the attempts that we made.\n\n\nCollect retry attempt data\nTo find out which attempts we made for a payment, set up receiving retry attempt data in your payment responses and webhooks.\nTo set up receiving retry attempt data:\n\nLog in to your Customer Area.\nGo to Developers &gt; Additional data.\nIn the Acquirer section, select Include the retry attempts.\nSelect Save configuration.\n\nRetry attempt data\nWhen you collect retry attempt data, the additionalData object in your payment response contains a set of parameters for each attempt that we made. In the parameter names, attemptN is the number of the attempt: attempt1 for the attempt with the network token, and attempt2 for the attempt with the PAN.\n\n\n\nParameter name\nDescription\n\n\n\n\nretry.attemptN.acquirer\nThe name of the acquirer that processed the attempt.\n\n\nretry.attemptN.acquirerAccount\nThe acquirer account that was used for the attempt.\n\n\nretry.attemptN.responseCode\nThe numeric acquirer response code from the card network.\n\n\nretry.attemptN.rawResponse\nThe details of the raw unmodified response from the acquirer.\n\n\n\nThe AUTHORISATION webhook contains the same information as the additionalData object from your payment response.\nThe following examples show the additionalData object for each possible outcome.\n\n\n    \n        \n        \n    \n\n\nSee also\n\n\n                    Network tokenization\n                \n                    Raw acquirer responses\n                \n                    Webhooks\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Network tokenization","lvl3":"PAN fallback for network tokens"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/online-payments","lvl2":"https:\/\/docs.adyen.com\/online-payments\/network-tokenization","lvl3":"\/online-payments\/network-tokenization\/pan-fallback"},"levels":4,"category":"Online Payments","category_color":"green","tags":["fallback","network","tokens"]}}
