{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/3ds/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/3ds/openapi"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"custom_product":"3DS","type":"markdown"},"seo":{"title":"Versioning and change log | 3DS 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":"Heading","attributes":{"level":1,"id":"versioning-and-change-log","__idx":0},"children":["Versioning and change log"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This log details any breaking and non-breaking API changes we have released for our 3DS service."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Prerequisite"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make yourself familiar with our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/api-principles"},"children":["API principles"]}," to ensure a resilient integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"versioning-log","__idx":1},"children":["Versioning log"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-3-12-may-2021","__idx":2},"children":["Version 3 (12 May 2021)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["New test values"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}," changed to version 3:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\nContent-Type: application/vnd.worldpay.verifications.customers-v3.hal+json\nAccept: application/vnd.worldpay.verifications.customers-v3.hal+json\n\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/testing"},"children":["Test card values"]}," for the v3 have changed to support Android and iOS SDK testing"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-2-26-february-2020","__idx":3},"children":["Version 2 (26 February 2020)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Error handling"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}," changed to version 2:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\nContent-Type: application/vnd.worldpay.verifications.customers-v2.hal+json\nAccept: application/vnd.worldpay.verifications.customers-v2.hal+json\n\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Error responses no longer contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," as keys"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Invalid card numbers are now producing an error message"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"validationErrors\": [\n  {\n    \"errorName\": \"fieldHasInvalidValue\",\n    \"jsonPath\": \"$.instruction.paymentInstrument.cardNumber\",\n    \"message\": \"Card number is invalid\"\n  }\n],\n"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"change-log-non-breaking-changes","__idx":4},"children":["Change log (non-breaking changes)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"google-pay-09-june-2026","__idx":5},"children":["Google Pay (09 June 2026)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/openapi/other/devicedatainitialize#other/devicedatainitialize/t=request&path=paymentinstrument"},"children":["authenticate a customer using a Google Pay ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"authentication-outage-22-april-2025","__idx":6},"children":["Authentication outage (22 April 2025)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Receive an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticationOutage"]}," outcome in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication"},"children":["authentication"]}," response if there are downstream issues (Visa/Mastercard etc). You can use this as a prompt to apply an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authenticationOutage"]}," exemption in the payment authorization request."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"new-challenge-preference-value-19-february-2025","__idx":7},"children":["New challenge preference value (19 February 2025)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now submit a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["challenge.preference"]}," value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["noChallengeRequestedTRAPerformed"]}," in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/openapi/other/authenticate#other/authenticate/t=request&path=challenge/preference"},"children":["3DS authentication request"]},". You can use this when Transaction Risk Analysis (TRA) has been performed using an approved third party vendor and an SCA exemption has been recommended for the authentication."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2024"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"react-native-support-08-october-2024","__idx":8},"children":["React Native support (08 October 2024)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We have documented ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/react-native/"},"children":["code samples"]}," showing you how to integrate our 3DS flow in a React Native application."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"additional-browser-fields-for-authentication-requests-17-july-2024","__idx":9},"children":["Additional browser fields for authentication requests (17 July 2024)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now submit the following fields in your authentication request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.timeZone"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.browserScreenWidth"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.browserScreenHeight"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.browserColorDepth"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.javascriptBrowserEnabled"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData.javaBrowserEnabled"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"added-support-for-cartes-bancaires-in-3ds2-authentications-10-january-2024","__idx":10},"children":["Added support for Cartes Bancaires in 3DS2 authentications (10 January 2024)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We now provide additional values in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication#authentication-responses"},"children":["authentication and 3DS verification responses"]}," when the card brand is Cartes Bancaires. These additional values must then be applied in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorize-a-payment"},"children":["authorization request"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"network-payment-token-as-new-payment-instrument-v2--v3-10-january-2024","__idx":11},"children":["Network Payment Token as new payment instrument (v2 + v3) (10 January 2024)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now authenticate a Network Payment Token using the \"card/networkToken\" `paymentInstrument via the 3DS ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/android-ios/authentication#authentication-example-request"},"children":["SDK"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication#authentication-example-request"},"children":["Web"]}," flow."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2023"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-override-field-for-authentication-requests-15-february-2023","__idx":12},"children":["Optional override field for authentication requests (15 February 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You now have the option to send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["overrideName"]}," in your authentication request with our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication"},"children":["3DS Web API"]},". This field allows you to override the merchant name sent to the issuer."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-shipping-address-fields-in-3ds-authentication-request-v2v3-15-february-2023","__idx":13},"children":["Optional shipping address fields in 3DS authentication request (v2/v3) (15 February 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You now have the option to send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shippingAddress"]}," in the authentication request for our 3DS ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication"},"children":["Web API"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/android-ios/authentication"},"children":["Android-iOS SDKs"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend you send these details, if the shipping address is different to the billing address."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2022"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"3ds1-test-values-unavailability-18-october-2022","__idx":14},"children":["3DS1 test values unavailability (18 October 2022)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["3DS1 test values are no longer available by default as 3DS1 has been decommissioned by the card schemes. The test values can be enabled if required."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-cardholder-name-field-in-authentication-request-12-october-2022","__idx":15},"children":["Optional cardholder name field in authentication request (12 October 2022)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardHolderName"]}," field is no longer mandatory in authentication requests."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-device-data-fields-in-authentication-request-v2v3-10-october-2022","__idx":16},"children":["Optional device data fields in authentication request (v2/v3) (10 October 2022)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You now have an option to send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserLanguage"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ipAddress"]}," fields in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceData"]}," object of the authentication request for 3DS ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication"},"children":["Web API"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/android-ios/authentication"},"children":["Android-iOS SDKs"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In case of unsuccessful device data collection, providing these values will increase the chances of successful authentication."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2021"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"new-error-message-returned-when-using-duplicate-transactionreference-v2v3-14-september-2021","__idx":17},"children":["New error message returned when using duplicate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}," (v2/v3) (14 September 2021)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For versions 2 and 3 we now return a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReferenceIsADuplicate"]}," error instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unavailable"]}," when a duplicate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}," is used for an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication"]}," request."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2020"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"authentication-challenge-response-now-contains-payload-v2-26-may-2020","__idx":18},"children":["Authentication challenge response now contains payload (v2) (26 May 2020)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As part of changes to support a native mobile integration for 3DS2 we have made a new key:value available. The challenge object in the authentication response now contains the following:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"challenge {\n...\n\n\"payload\": \"eJxdUttugkAQ/RXic2V3qUgx4xqsTeqDplH6AQgToZGLu0vBfn13EcV1EpI558zMMhdYtPnJ...\"\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"transactionid-in-3ds1-signaturefailed-outcome-v2-26-may-2020","__idx":19},"children":["transactionId in 3DS1 signatureFailed outcome (v2) (26 May 2020)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If provided, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]}," is returned as part of the 3DS1 authentication ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureFailed"]}," outcome. Whilst you should not proceed with payment authorization, the value can be useful for tracing."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cardinal-sdk-change-log","__idx":20},"children":["Cardinal SDK Change log"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Access 3DS API is periodically tested against the latest version of the Cardinal SDK. Current tested Cardinal SDK version:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Android: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2.2.7"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["iOS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2.2.5"]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cardinaldocs.atlassian.net/wiki/x/3IJUdw"},"children":["iOS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cardinaldocs.atlassian.net/wiki/x/EQC1"},"children":["Android"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"SDK updates"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We strongly recommend signing up ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://win.cardinalcommerce.com/CardinalMobileSDKNotifications"},"children":["here"]}," so you are kept informed of SDK updates."]}]}]},"headings":[{"value":"Versioning and change log","id":"versioning-and-change-log","depth":1},{"value":"Versioning log","id":"versioning-log","depth":2},{"value":"Version 3 (12 May 2021)","id":"version-3-12-may-2021","depth":4},{"value":"Version 2 (26 February 2020)","id":"version-2-26-february-2020","depth":4},{"value":"Change log (non-breaking changes)","id":"change-log-non-breaking-changes","depth":2},{"value":"Google Pay (09 June 2026)","id":"google-pay-09-june-2026","depth":4},{"value":"Authentication outage (22 April 2025)","id":"authentication-outage-22-april-2025","depth":4},{"value":"New challenge preference value (19 February 2025)","id":"new-challenge-preference-value-19-february-2025","depth":4},{"value":"React Native support (08 October 2024)","id":"react-native-support-08-october-2024","depth":4},{"value":"Additional browser fields for authentication requests (17 July 2024)","id":"additional-browser-fields-for-authentication-requests-17-july-2024","depth":4},{"value":"Added support for Cartes Bancaires in 3DS2 authentications (10 January 2024)","id":"added-support-for-cartes-bancaires-in-3ds2-authentications-10-january-2024","depth":4},{"value":"Network Payment Token as new payment instrument (v2 + v3) (10 January 2024)","id":"network-payment-token-as-new-payment-instrument-v2--v3-10-january-2024","depth":4},{"value":"Optional override field for authentication requests (15 February 2023)","id":"optional-override-field-for-authentication-requests-15-february-2023","depth":4},{"value":"Optional shipping address fields in 3DS authentication request (v2/v3) (15 February 2023)","id":"optional-shipping-address-fields-in-3ds-authentication-request-v2v3-15-february-2023","depth":4},{"value":"3DS1 test values unavailability (18 October 2022)","id":"3ds1-test-values-unavailability-18-october-2022","depth":4},{"value":"Optional cardholder name field in authentication request (12 October 2022)","id":"optional-cardholder-name-field-in-authentication-request-12-october-2022","depth":4},{"value":"Optional device data fields in authentication request (v2/v3) (10 October 2022)","id":"optional-device-data-fields-in-authentication-request-v2v3-10-october-2022","depth":4},{"value":"New error message returned when using duplicate transactionReference (v2/v3) (14 September 2021)","id":"new-error-message-returned-when-using-duplicate-transactionreference-v2v3-14-september-2021","depth":4},{"value":"Authentication challenge response now contains payload (v2) (26 May 2020)","id":"authentication-challenge-response-now-contains-payload-v2-26-may-2020","depth":4},{"value":"transactionId in 3DS1 signatureFailed outcome (v2) (26 May 2020)","id":"transactionid-in-3ds1-signaturefailed-outcome-v2-26-may-2020","depth":4},{"value":"Cardinal SDK Change log","id":"cardinal-sdk-change-log","depth":2}],"frontmatter":{"seo":{"title":"Versioning and change log | 3DS API"}},"lastModified":"2026-06-09T11:30:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/3ds/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}