{"title":"Install the Authentication SDK for mobile devices","category":"default","creationDate":1674831720,"content":"<p>To help you implement OOB authentication, we provide a client-side Authentication SDK that uses the possession factor through device binding, and either knowledge or the inherence factor, depending on the cardholder's device access configuration.<\/p>\n<p>With Adyen's Authentication SDK, you can:<\/p>\n<ul>\n<li>Check if the cardholder's device is eligible for Strong Customer Authentication (SCA).<\/li>\n<li>Register your cardholder's mobile device to create device binding.<\/li>\n<li>Authenticate your cardholder's online card transactions with 3D Secure.<\/li>\n<\/ul>\n<div class=\"notices green\">\n<p>The Authentication SDK integration also enables you to implement SCA for Adyen's <a href=\"\/pt\/business-accounts\">Business Accounts<\/a>.<\/p>\n<\/div>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">This feature is supported with an <a href=\"\/pt\/platforms\">Adyen for Platforms<\/a> integration.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Client-side requirements<\/h3>\n<p>We provide the client-side Authentication SDK in the following languages: <ul><li markdown=\"1\"><strong>Kotlin<\/strong> or <strong>Java<\/strong> for native Android applications<\/li><li markdown=\"1\"><strong>Swift<\/strong> for native iOS applications<\/li><\/ul>Before you start implementing the SDK, make sure that your system follows the requirements:                                                                                                                                                                                                                                                                                                                                                                                                                                     |<\/p>\n\n<div id=\"tabi9guX\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Android (Kotlin)&quot;,&quot;content&quot;:&quot;\\n&lt;ul&gt;\\n&lt;li&gt;Your application targets minimum Android API level 21 or later.&lt;\\\/li&gt;\\n&lt;li&gt;The authentication feature works on devices running on Android API level 26 and later.&lt;\\\/li&gt;\\n&lt;li&gt;The authentication feature requires &lt;a href=\\&quot;https:\\\/\\\/developers.google.com\\\/android\\\/guides\\\/setup\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Google Play Services&lt;\\\/a&gt; on the cardholder&#039;s device.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;kotlin&quot;,&quot;oldTabId&quot;:&quot;requirements-kotlin_1&quot;,&quot;relation&quot;:&quot;kotlin&quot;},{&quot;title&quot;:&quot;iOS (Swift)&quot;,&quot;content&quot;:&quot;\\n&lt;ul&gt;\\n&lt;li&gt;Your application targets iOS 14 or later.&lt;\\\/li&gt;\\n&lt;li&gt;Your developer environment runs Xcode 13.2 or later.&lt;\\\/li&gt;\\n&lt;li&gt;Your developer environment runs Swift 5.5 or later (pre-installed with Xcode 13.2).&lt;\\\/li&gt;\\n&lt;li&gt;To use the LIVE environment, your application must be a &lt;a href=\\&quot;https:\\\/\\\/testflight.apple.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;TestFlight&lt;\\\/a&gt; or App Store release build. Do &lt;strong&gt;not&lt;\\\/strong&gt; use debug builds from Xcode.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;swift&quot;,&quot;oldTabId&quot;:&quot;requirements-swift_2&quot;,&quot;relation&quot;:&quot;swift&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Installation<\/h2>\n<p>The following tabs explain how to install the Authentication SDK using Kotlin or Swift.<\/p>\n\n<div id=\"tabwVge8\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Android (Kotlin)&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;To install the Authentication SDK, add the following line to your &lt;code&gt;build.gradle&lt;\\\/code&gt; file.&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-kotlin\\&quot;&gt;implementation \\&quot;com.adyen.authentication:android-authentication:0.2.1\\&quot;&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;kotlin&quot;,&quot;oldTabId&quot;:&quot;requirements-kotlin_1&quot;,&quot;relation&quot;:&quot;kotlin&quot;},{&quot;title&quot;:&quot;iOS (Swift)&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To install the Authentication SDK, use one of the following package managers:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;a href=\\&quot;https:\\\/\\\/swift.org\\\/package-manager\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Swift Package Manager&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;https:\\\/\\\/github.com\\\/Carthage\\\/Carthage\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Carthage&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;http:\\\/\\\/cocoapods.org\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;CocoaPods&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The following subsections list the installation steps that correspond to each package manager.&lt;\\\/p&gt;\\n&lt;h3&gt;Swift Package Manager&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Follow the &lt;a href=\\&quot;https:\\\/\\\/developer.apple.com\\\/documentation\\\/xcode\\\/adding_package_dependencies_to_your_app\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Apple&#039;s Adding Package Dependencies to Your App&lt;\\\/a&gt; guide on how to add a Swift Package dependency.&lt;\\\/li&gt;\\n&lt;li&gt;Use &lt;code&gt;https:\\\/\\\/github.com\\\/Adyen\\\/adyen-authentication-ios&lt;\\\/code&gt; for the repository URL.&lt;\\\/li&gt;\\n&lt;li&gt;Specify the minimum version of &lt;strong&gt;1.0.0&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3&gt;Carthage&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Add &lt;code&gt;github adyen\\\/adyen-authentication-ios&lt;\\\/code&gt; to your Cartfile.&lt;\\\/li&gt;\\n&lt;li&gt;Run &lt;code&gt;carthage update&lt;\\\/code&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Link the framework with your target as described in &lt;a href=\\&quot;https:\\\/\\\/github.com\\\/Carthage\\\/Carthage#adding-frameworks-to-an-application\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Carthage Readme&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3&gt;CocoaPods&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Add &lt;code&gt;pod &#039;AdyenAuthentication&#039;&lt;\\\/code&gt; to your Podfile.&lt;\\\/li&gt;\\n&lt;li&gt;Run &lt;code&gt;pod install&lt;\\\/code&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;swift&quot;,&quot;oldTabId&quot;:&quot;requirements-swift_2&quot;,&quot;relation&quot;:&quot;swift&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n","url":"https:\/\/docs.adyen.com\/pt\/issuing\/3d-secure\/oob-auth-sdk\/install-sdk-mobile","articleFields":{"description":"Learn how to install Adyen's Authentication SDK for implementing out-of-band authentication.","feedback_component":true,"type":"page","_expandable":{"operations":""},"status":"current","next_steps_description":"Register and manage your user's devices for strong customer authentication.","next_steps":[{"title":"Register a mobile SCA device","description":"Learn how to use our Authentication SDK to register an iOS or Android device for OOB purposes.","url":"\/issuing\/3d-secure\/oob-auth-sdk\/register-devices","required":true},{"title":"Manage SCA devices","description":"Learn how to manage registered SCA devices.","url":"\/issuing\/3d-secure\/oob-auth-sdk\/manage-devices","required":false}],"parameters":{"integrationType":"issuing","directoryPath":"\/issuing"},"last_edit_on":"12-07-2023 13:49","filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/3d-secure\/oob-auth-sdk\/install-sdk-mobile","title":"Install the Authentication SDK for mobile devices","content":"To help you implement OOB authentication, we provide a client-side Authentication SDK that uses the possession factor through device binding, and either knowledge or the inherence factor, depending on the cardholder's device access configuration.\nWith Adyen's Authentication SDK, you can:\n\nCheck if the cardholder's device is eligible for Strong Customer Authentication (SCA).\nRegister your cardholder's mobile device to create device binding.\nAuthenticate your cardholder's online card transactions with 3D Secure.\n\n\nThe Authentication SDK integration also enables you to implement SCA for Adyen's Business Accounts.\n\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nThis feature is supported with an Adyen for Platforms integration.\n\n\n\nClient-side requirements\nWe provide the client-side Authentication SDK in the following languages: Kotlin or Java for native Android applicationsSwift for native iOS applicationsBefore you start implementing the SDK, make sure that your system follows the requirements:                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n\n\n    \n        \n        \n    \n\n\nInstallation\nThe following tabs explain how to install the Authentication SDK using Kotlin or Swift.\n\n\n    \n        \n        \n    \n\n\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Enroll cards in 3D Secure","lvl3":"Using the out-of-band authentication SDK","lvl4":"Install the Authentication SDK for mobile devices"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/issuing","lvl2":"https:\/\/docs.adyen.com\/pt\/issuing\/3d-secure","lvl3":"https:\/\/docs.adyen.com\/pt\/issuing\/3d-secure\/oob-auth-sdk","lvl4":"\/pt\/issuing\/3d-secure\/oob-auth-sdk\/install-sdk-mobile"},"levels":5,"category":"Issuing","category_color":"green","tags":["Install","Authentication","mobile","devices"]}}