{"templateId":"markdown","versions":[{"version":"20240601","label":"2024-06-01 (Latest)","link":"/products/payments/enable-features/3ds-authentication/integrated-3ds","default":true,"active":true,"folderId":"15ab58d6"}],"sharedDataIds":{"sidebar":"sidebar-products/payments/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/payments/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","cards","card","tabs","tab","code-snippet"]},"custom_product":"Payments","type":"markdown"},"seo":{"title":"Integrated 3DS Authentication | Payments API","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 19 May 2026 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrated-3ds-authentication","__idx":0},"children":["Integrated 3DS authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrated 3DS"]}," when you want Worldpay to orchestrate 3DS authentication as part of the payment flow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With Integrated 3DS, Payments API handles the authentication orchestration and returns the actions you need to continue the payment. Depending on the issuer's decision, the customer may complete a frictionless authentication or be asked to complete a challenge."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide is for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDS.type: \"integrated\""]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have already authenticated the customer using your own MPI, 3DS Server, PSP, or authentication provider, use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/external-3ds"},"children":["External 3DS"]}," instead."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-integrated-3ds-works","__idx":1},"children":["How Integrated 3DS works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At a high level, the Integrated 3DS payment flow works as follows:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDS"]}," object to the payments request to enable 3DS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A response outcome of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3dsDeviceDataRequired"]}," will provide details to perform the issuer's Device Data Collection on the customer's browser."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resume the payment using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supply3dsDeviceData"]}," action from the response. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["frictionless"]}," the payment will proceed and authorize."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the outcome is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3dsChallenged"]}," details will be provided to display the issuer's challenge page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resume the payment using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete3dsChallenge"]}," action from the response to proceed with the payment."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some authentications are frictionless. If the issuer does not require a challenge, the payment continues after Device Data Collection and proceeds to authorization."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integrated-3ds-request","__idx":2},"children":["Integrated 3DS request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable Integrated 3DS, include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDS.type: \"integrated\""]}," in the payment request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"instruction\": {\n ...\n \"threeDS\": {\n \"type\": \"integrated\",\n \"mode\": \"always\",\n \"challenge\": {\n \"returnUrl\": \"https://payment.example.com/3ds/return\"\n },\n \"deviceData\": {\n \"acceptHeader\": \"text/html\",\n \"userAgentHeader\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"browserLanguage\": \"en-GB\",\n \"browserScreenHeight\": 1200,\n \"browserScreenWidth\": 900,\n \"browserJavaEnabled\": true,\n \"browserColorDepth\": \"32\",\n \"timeZone\": \"300\",\n \"browserJavascriptEnabled\": true,\n \"channel\": \"browser\"\n }\n }\n }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If 3DS authentication is not available or not applicable for the payment, for example for some subsequent recurring transactions or unsupported payment methods, a validation error may be returned."]}]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":1,"cardMinWidth":220},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"View the full API request schema","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"outlined","to":"/products/payments/openapi/payment"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-your-integrated-3ds-implementation-guide","__idx":3},"children":["Choose your Integrated 3DS implementation guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Integrated 3DS flow depends on your client environment. Choose the guide that matches your checkout experience."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":220},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Web","icon":"/assets/icons/lang/javascript-plain.svg","iconRawContent":"","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/payments/enable-features/3ds-authentication/integrated-3ds/web"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use browser-based Device Data Collection and challenge display with iframes and postMessage."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Android and iOS","icon":"/assets/icons/lang/android-apple.svg","iconRawContent":"","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/payments/enable-features/3ds-authentication/integrated-3ds/android-ios"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Cardinal mobile SDK for native Android and iOS integrations."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"React Native","icon":"/assets/icons/lang/react-original.svg","iconRawContent":"","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/payments/enable-features/3ds-authentication/integrated-3ds/react-native"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use React Native with WebView-based Device Data Collection and challenge flows."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integrated-3ds-sequence-diagram","__idx":4},"children":["Integrated 3DS sequence diagram"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"3DS Web (frictionless)","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card payment with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/integrated-3ds"},"children":["3DS authentication enabled"]},", resulting in a frictionless issuer response."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Issuer: Authorization request\n Issuer->>Payments_API: Authorization response\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Payments_API: Settlement request\n Payments_API->>Merchant_Backend: Settlement response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n","diagramHtml":"","diagramHtmlDark":""},"children":["\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Issuer: Authorization request\n Issuer->>Payments_API: Authorization response\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Payments_API: Settlement request\n Payments_API->>Merchant_Backend: Settlement response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"3DS Web (challenge)","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card payment with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/integrated-3ds"},"children":["3DS authentication enabled"]},", resulting in a challenged issuer response."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_Frontend: Challenge JWT/URL\n Merchant_Frontend->>Browser: 3DS challenge form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: Return to merchant site\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n\n","diagramHtml":"","diagramHtmlDark":""},"children":["\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_Frontend: Challenge JWT/URL\n Merchant_Frontend->>Browser: 3DS challenge form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: Return to merchant site\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n\n"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"3DS iOS/Android (challenge)","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card payment with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/integrated-3ds"},"children":["3DS authentication enabled"]},", resulting in a challenged issuer response."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"\nsequenceDiagram\n participant Merchant_App as Merchant App\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Merchant_App->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_App: DeviceData - JWT\n Note over Merchant_App: Cardinal SDK: Initialize\n Merchant_App-->>Issuer: Device App data\n Issuer-->>Merchant_App: consumerSessionId \n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Note left of Payments_API: Includes consumerSessionId\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_App: Challenge - Payload\n Note over Merchant_App: Cardinal SDK: Display Challenge\n Merchant_App-->>Issuer: Challenge Data\n Issuer-->>Merchant_App: Challenge Complete\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_App: Transaction complete\n Note left of Merchant_App: Order receipt page\n\n","diagramHtml":"","diagramHtmlDark":""},"children":["\nsequenceDiagram\n participant Merchant_App as Merchant App\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Issuer\n Merchant_App->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_App: DeviceData - JWT\n Note over Merchant_App: Cardinal SDK: Initialize\n Merchant_App-->>Issuer: Device App data\n Issuer-->>Merchant_App: consumerSessionId \n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Note left of Payments_API: Includes consumerSessionId\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_App: Challenge - Payload\n Note over Merchant_App: Cardinal SDK: Display Challenge\n Merchant_App-->>Issuer: Challenge Data\n Issuer-->>Merchant_App: Challenge Complete\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_App: Transaction complete\n Note left of Merchant_App: Order receipt page\n\n"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Example using Checkout SDK","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example using the Checkout SDK to provide the card details using a low PCI set of hosted card fields. The rest of the flow is the same as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3DS Web (challenge)"]}," tab."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Checkout_Sessions as Checkout Sessions\n participant Issuer\n Note over Merchant_Frontend: Checkout JS added to page \n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Checkout_Sessions: Create session\n Checkout_Sessions->>Merchant_Frontend: Return session \n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Note over Merchant_Backend,Payments_API: Using Checkout SDK session\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_Frontend: Challenge JWT/URL\n Merchant_Frontend->>Browser: 3DS challenge form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: Return to merchant site\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n\n","diagramHtml":"","diagramHtmlDark":""},"children":["\nsequenceDiagram\n participant Browser\n participant Merchant_Frontend as Merchant Frontend\n participant Merchant_Backend as Merchant Backend\n participant Payments_API as Payments API\n participant Checkout_Sessions as Checkout Sessions\n participant Issuer\n Note over Merchant_Frontend: Checkout JS added to page \n Browser->>Merchant_Frontend: Click Pay\n Merchant_Frontend->>Checkout_Sessions: Create session\n Checkout_Sessions->>Merchant_Frontend: Return session \n Merchant_Frontend->>Merchant_Backend: Pay \n Merchant_Backend->>Payments_API: Payment request\n Note over Merchant_Backend,Payments_API: Using Checkout SDK session\n Payments_API->>Merchant_Backend: Payment response\n Merchant_Backend->>Merchant_Frontend: DeviceData - BIN/JWT/URL\n Merchant_Frontend->>Browser: 3DS Device Data form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: PostMessage: dfReferenceId\n Merchant_Backend->>Payments_API: 3dsDeviceData request\n Payments_API->>Merchant_Backend: 3dsDeviceData response\n Merchant_Backend->>Merchant_Frontend: Challenge JWT/URL\n Merchant_Frontend->>Browser: 3DS challenge form\n Browser-->>Issuer: Form post\n Issuer-->>Browser: Return to merchant site\n Merchant_Backend->>Payments_API: 3dsChallenges request\n Payments_API->>Issuer: Authorization Request\n Issuer->>Payments_API: Authorization Response\n Payments_API->>Merchant_Backend: 3dsChallenges response\n Merchant_Backend->>Payments_API: Settlements request\n Payments_API->>Merchant_Backend: Settlements response\n Merchant_Backend->>Merchant_Frontend: Transaction complete\n Note left of Merchant_Frontend: Order receipt page\n\n"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"device-data-collection","__idx":5},"children":["Device Data Collection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Payments API returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3dsDeviceDataRequired"]},", the response includes the information required to perform Device Data Collection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response also includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supply3dsDeviceData"]}," action. Use this action to resume the payment after Device Data Collection has completed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"outcome\": \"3dsDeviceDataRequired\",\n \"deviceDataCollection\": {\n \"jwt\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...\",\n \"url\": \"https://centinelapistag.cardinalcommerce.com/V1/Cruise/Collect\",\n \"bin\": \"400000\"\n },\n \"_actions\": {\n \"supply3dsDeviceData\": {\n \"href\": \"https://try.access.worldpay.com/api/payments/{linkData}/3dsDeviceData\",\n \"method\": \"POST\"\n }\n }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After Device Data Collection completes, resume the payment by sending the collection reference to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supply3dsDeviceData"]}," action."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"collectionReference\": \"0_3XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX6b5\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you do not provide a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["collectionReference"]},", you may see an increased number of challenged or authentication failed outcomes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"challenge-and-verification","__idx":6},"children":["Challenge and verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the issuer requires additional verification, the response from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supply3dsDeviceData"]}," action includes an outcome of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3dsChallenged"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"outcome\": \"3dsChallenged\",\n \"authentication\": {\n \"version\": \"2.2.0\"\n },\n \"challenge\": {\n \"reference\": \"706hovL8DK1tIGGzQUV1\",\n \"url\": \"https://centinelapistag.cardinalcommerce.com/V2/Cruise/StepUp\",\n \"jwt\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...\",\n \"payload\": \"eyJtZXNzYWdlVHlwZSI6Ik...\"\n },\n \"_actions\": {\n \"complete3dsChallenge\": {\n \"href\": \"https://try.access.worldpay.com/api/payments/{linkData}/3dsChallenges\",\n \"method\": \"POST\"\n }\n }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must display the issuer challenge to the customer using the implementation approach for your client environment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the customer completes the challenge, resume the payment using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete3dsChallenge"]}," action. No request body is required."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you do not complete the challenge display, the payment fails when you call the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete3dsChallenge"]}," action."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-much-data-to-provide","__idx":7},"children":["How much data to provide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The issuer uses ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/integrated-3ds/web#2-device-data-collection-ddc"},"children":["device data"]}," and certain values in the Payments API request to decide if the transaction is likely to be fraudulent.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","How this data is interpreted varies by issuer. Supplying more data increases the chances of the outcome being frictionless (without a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/web#4challenge-and-verification"},"children":["challenge"]},").",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Some issuers may fail the authentication entirely without the recommended fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Below is our latest guide on what to include."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Objects used for 3DS authentication:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardNumber"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAddress"]}," - core payment details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS"]}," - for 3DS specific data, some are mandatory"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer"]}," - firstName, lastName, email, phone, dateOfBirth, ipAddress"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"emvco-required-values","__idx":8},"children":["EMVco required values"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.cardHolderName"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.email"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.firstName"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.lastName"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.phoneNumber"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}," Either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.email"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.phoneNumber"]}," are required."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["2"]}," Only required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.cardHolderName"]}," is not provided."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following are considered mandatory by EMVco and are already part of Device Data Collection. We recommend providing these in the API request along with other device values to maximize authentication rates if ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#device-data-collection-failure"},"children":["Device Data Collection fails"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserScreenWidth"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserScreenHeight"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.ipAddress"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}," Provide for web/browser integration only."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"emvco-recommended-values","__idx":9},"children":["EMVco recommended values"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.billingAddress.city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.billingAddress.country"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.billingAddress.address1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.billingAddress.postalCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.billingAddress.state"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"device-data-collection-failure","__idx":10},"children":["Device Data Collection failure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the event the Device Data Collection fails to run (browser/native), additionally provide the following in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/openapi/payment"},"children":["payment request"]}," to maintain healthy authentication rates and reduce issuer challenges:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[" Providing the data below directly in the API request should not be viewed as an alternative to running the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/3ds-authentication/web#device-data-collection-form"},"children":["Device Data Collection form"]},". It is a fallback only. "]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.customer.ipAddress"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserLanguage"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserScreenHeight"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserScreenWidth"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserJavaEnabled"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserColorDepth"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.timeZone"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.browserJavascriptEnabled"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.threeDS.deviceData.channel"]}," ",{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"sup","attributes":{},"children":["1"]}," Only these values apply to (iOS/Android), the others are not applicable."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"outcome-details","__idx":11},"children":["Outcome details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A summary of the 3DS authentication is included in the final payment response when available."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Authentication successful","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"threeDS\": {\n \"type\": \"integrated\",\n \"outcome\": \"authenticated\",\n \"issuerResponse\": \"frictionless\",\n \"version\": \"2.2.0\",\n \"eci\": \"05\"\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Authentication successful after challenge","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"threeDS\": {\n \"type\": \"integrated\",\n \"outcome\": \"authenticated\",\n \"issuerResponse\": \"challenged\",\n \"version\": \"2.2.0\",\n \"eci\": \"05\"\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Authentication outage","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n \"threeDS\": {\n \"type\": \"integrated\",\n \"outcome\": \"authenticationOutage\"\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Authentication failed","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Issuer failed the authentication following the challenge."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../examples/extended/response/response-authentication-failed.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n\t\"transactionReference\": \"05651339-d94e-4fdd-82e9-a41d3df47c7d\",\n\t\"outcome\": \"3dsAuthenticationFailed\",\n\t\"authentication\": {\n\t\t\"version\": \"2.1.0\",\n\t\t\"eci\": \"07\",\n\t\t\"transactionId\": \"ec89944d-c5b1-4d4b-b39a-a2dc80dd5565\"\n\t}\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Unavailable","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An error or timeout occurred while attempting authentication."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../examples/extended/response/response-unavailable.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n\t\"transactionReference\": \"700cb517-02c6-4dfe-a9dc-a5f77ae101bb\",\n\t\"outcome\": \"3dsUnavailable\"\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-outage-exemptions","__idx":12},"children":["Authentication outage exemptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authentication outage exemptions are currently not part of the default merchant setup. Please speak to your Worldpay Implementation Manager to enable this feature."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once enabled, you can set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDS.exemptionOnOutage"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," in the request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"threeDS\": {\n \"type\": \"integrated\",\n \"mode\": \"always\",\n \"exemptionOnOutage\": true\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exemption increases the likelihood of receiving a successful authorization if a 3DS network outage occurs, but the transaction is not eligible for liability shift."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response body includes the following if an authentication outage exemption is used:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"threeDS\": {\n \"outcome\": \"authenticationOutage\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next steps"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/enable-features/sca-exemptions"},"children":["SCA Exemptions"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments/testing"},"children":["Testing (3DS tab)"]}," for scenario details and magic test values"]}]}]},"headings":[{"value":"Integrated 3DS authentication","id":"integrated-3ds-authentication","depth":1},{"value":"How Integrated 3DS works","id":"how-integrated-3ds-works","depth":2},{"value":"Integrated 3DS request","id":"integrated-3ds-request","depth":2},{"value":"Choose your Integrated 3DS implementation guide","id":"choose-your-integrated-3ds-implementation-guide","depth":2},{"value":"Integrated 3DS sequence diagram","id":"integrated-3ds-sequence-diagram","depth":2},{"value":"Device Data Collection","id":"device-data-collection","depth":2},{"value":"Challenge and verification","id":"challenge-and-verification","depth":2},{"value":"How much data to provide","id":"how-much-data-to-provide","depth":2},{"value":"EMVco required values","id":"emvco-required-values","depth":3},{"value":"EMVco recommended values","id":"emvco-recommended-values","depth":4},{"value":"Device Data Collection failure","id":"device-data-collection-failure","depth":3},{"value":"Outcome details","id":"outcome-details","depth":2},{"value":"Authentication outage exemptions","id":"authentication-outage-exemptions","depth":2}],"frontmatter":{"seo":{"title":"Integrated 3DS Authentication | Payments API"}},"lastModified":"2026-05-19T08:45:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments/enable-features/3ds-authentication/integrated-3ds","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}