{"title":"Data-only flow","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice warning\"><div>\n<p><strong>Adyen is no longer developing the Classic API integration<\/strong><\/p>\n<p>This page is for the Classic API (<code>\/authorise<\/code>) integration, which we no longer accept new integrations with. <\/p>\n<p>We strongly recommend migrating to the newer <a href=\"\/online-payments\/3d-secure\/other-3ds-flows\/data-only\">data-only integration on Checkout API<\/a> integration. To use this newer integration, you must also <a href=\"\/pt\/online-payments\/upgrade-your-integration\/migrate-to-checkout-api\">migrate to the Checkout API<\/a>.<\/p>\n<\/div><\/div>\n<p>In a regular 3D Secure 2 flow, the payment has to be authenticated by the issuer before it can be authorised. In a data-only flow, you send the same 3D Secure 2 data but the schemes directly handle the authentication request. The data-only request goes directly to the scheme, and then the scheme includes their own risk data in the authorisation message before sending it to the issuer.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>Data-only is currently only available for Mastercard. Before using the data-only flow, make sure to check the regulations that apply to your country or region. Using the data-only flow in countries\/regions where SCA is mandated (for example, within the EEA) can lead to an increased amount of authentication rejections.<\/p>\n<\/div><\/div>\n<h2>Using the data-only flow<\/h2>\n<p>The data-only flow allows you to use the scheme's 3D Secure-specific risk scoring models, which helps increase your authorisation rates in specific markets, without incurring additional fees.<\/p>\n<p>You can also use the data-only flow when you integrate with Adyen as a standalone 3D Secure 2 provider with an <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/authentication-only-integration\">authentication-only implementation<\/a>.<\/p>\n<p>Because there is no authentication request sent to the issuer in a data-only flow, your shoppers will not be presented with a 3D Secure 2 challenge.<\/p>\n<div class=\"sc-notice warning\"><div>\n<p>Because no strong customer authentication is applied to a data-only transaction, the chargeback liability stays with you and does not shift to the issuer.<\/p>\n<\/div><\/div>\n<h2 id=\"before-you-begin\">Before\u00a0you begin<\/h2>\n<p>Before you can start accepting 3D Secure 2 authenticated transactions on browsers or in-app, make sure that you:<\/p>\n<ol>\n<li>Sign up for an Adyen test account at\u00a0<a href=\"https:\/\/www.adyen.com\/signup\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/www.adyen.com\/signup<\/a>.\u00a0<\/li>\n<li><a href=\"\/pt\/development-resources\/api-credentials#generate-api-key\">Get your API Key<\/a>. Save a copy\u00a0as you'll need it for API calls you make to the plataforma de pagamentos da Adyen.<\/li>\n<li>Install one of our\u00a0<a href=\"\/pt\/development-resources\/libraries\">Libraries<\/a>\u00a0to connect with the Adyen APIs. For more information on these steps, refer to\u00a0<a href=\"\/pt\/get-started-with-adyen\">Get started with Adyen<\/a>.<\/li>\n<\/ol>\n<h2 id=\"submit-a-data-only-request\">Submit a data-only payment request<\/h2>\n<p>To indicate that you want to use the data-only flow, specify in your <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Payment\/authorise\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/authorise<\/a>\u00a0 request:<\/p>\n<ul>\n<li><code>additionalData.threeDS2DataOnly<\/code>:\u00a0<strong>true<\/strong><\/li>\n<\/ul>\n<p>Other required fields and the response to your <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Payment\/authorise\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/authorise<\/a>\u00a0request are the same as in case of a regular 3D Secure flow, depending on your integration.<\/p>\n<p>For more information, refer to <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/browser-based-integration#submit-a-payment-request\">Browser-based integration<\/a>, <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/ios-sdk-integration\">iOS 3D Secure 2 SDK<\/a>, <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/android-sdk-integration\">Android 3D Secure 2 SDK<\/a>, or <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/authentication-only-integration\">Authentication-only integration<\/a>.<\/p>\n<h4 id=\"request\">Request<\/h4>\n<pre><code class=\"language-bash\">curl https:\/\/pal-test.adyen.com\/pal\/servlet\/Payment\/v50\/authorise \\\n-H 'x-api-key: ADYEN_API_KEY' \\\n-H 'content-type: application\/json' \\\n-d '{\n    ...\n    \"additionalData\": {\n      \"threeDS2DataOnly\": true\n    },\n    ...\n  }'<\/code><\/pre>\n<h2 id=\"testing-3d-secure-2\">Testing the data-only flow<\/h2>\n<p>Use the test card below to try the 3D Secure 2 data-only flow.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Card Type<\/th>\n<th style=\"text-align: left;\">Card Number<\/th>\n<th style=\"text-align: left;\">Expiry Date<\/th>\n<th style=\"text-align: left;\">CVC\/CVV<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Mastercard<\/td>\n<td style=\"text-align: left;\">5201 2818 2278 3116<\/td>\n<td style=\"text-align: left;\">10\/2020<\/td>\n<td style=\"text-align: left;\">737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/other-3ds-flows\/data-only","articleFields":{"description":"Implement 3D Secure 2 without sending an authentication request to the issuer.","id":"47486111","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"31-07-2019 09:56","sitemap":{"priority":0.3},"parameters":{"anchor_new":"<a href=\"\/online-payments\/3d-secure\/other-3ds-flows\/data-only\">data-only integration on Checkout API<\/a>","parent_page":"Classic API (<code>\/authorise<\/code>)","new_desc":"integrating using our Checkout APIs"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/other-3ds-flows\/data-only","title":"Data-only flow","content":"\nAdyen is no longer developing the Classic API integration\nThis page is for the Classic API (\/authorise) integration, which we no longer accept new integrations with. \nWe strongly recommend migrating to the newer data-only integration on Checkout API integration. To use this newer integration, you must also migrate to the Checkout API.\n\nIn a regular 3D Secure 2 flow, the payment has to be authenticated by the issuer before it can be authorised. In a data-only flow, you send the same 3D Secure 2 data but the schemes directly handle the authentication request. The data-only request goes directly to the scheme, and then the scheme includes their own risk data in the authorisation message before sending it to the issuer.\n\nData-only is currently only available for Mastercard. Before using the data-only flow, make sure to check the regulations that apply to your country or region. Using the data-only flow in countries\/regions where SCA is mandated (for example, within the EEA) can lead to an increased amount of authentication rejections.\n\nUsing the data-only flow\nThe data-only flow allows you to use the scheme's 3D Secure-specific risk scoring models, which helps increase your authorisation rates in specific markets, without incurring additional fees.\nYou can also use the data-only flow when you integrate with Adyen as a standalone 3D Secure 2 provider with an authentication-only implementation.\nBecause there is no authentication request sent to the issuer in a data-only flow, your shoppers will not be presented with a 3D Secure 2 challenge.\n\nBecause no strong customer authentication is applied to a data-only transaction, the chargeback liability stays with you and does not shift to the issuer.\n\nBefore\u00a0you begin\nBefore you can start accepting 3D Secure 2 authenticated transactions on browsers or in-app, make sure that you:\n\nSign up for an Adyen test account at\u00a0https:\/\/www.adyen.com\/signup.\u00a0\nGet your API Key. Save a copy\u00a0as you'll need it for API calls you make to the plataforma de pagamentos da Adyen.\nInstall one of our\u00a0Libraries\u00a0to connect with the Adyen APIs. For more information on these steps, refer to\u00a0Get started with Adyen.\n\nSubmit a data-only payment request\nTo indicate that you want to use the data-only flow, specify in your \/authorise\u00a0 request:\n\nadditionalData.threeDS2DataOnly:\u00a0true\n\nOther required fields and the response to your \/authorise\u00a0request are the same as in case of a regular 3D Secure flow, depending on your integration.\nFor more information, refer to Browser-based integration, iOS 3D Secure 2 SDK, Android 3D Secure 2 SDK, or Authentication-only integration.\nRequest\ncurl https:\/\/pal-test.adyen.com\/pal\/servlet\/Payment\/v50\/authorise \\\n-H 'x-api-key: ADYEN_API_KEY' \\\n-H 'content-type: application\/json' \\\n-d '{\n    ...\n    \"additionalData\": {\n      \"threeDS2DataOnly\": true\n    },\n    ...\n  }'\nTesting the data-only flow\nUse the test card below to try the 3D Secure 2 data-only flow.\n\n\n\nCard Type\nCard Number\nExpiry Date\nCVC\/CVV\n\n\n\n\nMastercard\n5201 2818 2278 3116\n10\/2020\n737\n\n\n","type":"page","locale":"pt","boost":14,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Classic API integration","lvl4":"3D Secure authentication","lvl5":"Other 3D Secure flows","lvl6":"Data-only flow"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration","lvl4":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication","lvl5":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/other-3ds-flows","lvl6":"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/other-3ds-flows\/data-only"},"levels":7,"category":"Online Payments","category_color":"green","tags":["Data-only"]}}
