Install 3DS SDK

Amend the dependencies section of your app's build.gradle to include the 3ds-android library. Paste this code, make sure to replace supported-3ds-sdk-version with the right value. See the table below to get the correct one:

12345

dependencies {  /* Other dependencies... */
  implementation "io.primer:3ds-android:{supported-3ds-sdk-version}"}

Interoperability matrix

Primer SDK internally uses Primer 3DS SDK as a compile time dependency. In order for the SDKs to work properly, the versions used internally and the one imported to your code must match.

Here is a breakdown of supported interoperable versions:

To validate that the 3DS SDK is imported correctly:

1. 1
   Clean and sync your project
2. 2
   Validate that library can be found in External Libraries section (if you use Android Studio)

Handle Out-of-Band (OOB) redirects (Optional)

Starting from 3D Secure protocol version 2.2.0, you can enhance the user experience by implementing an automatic redirect from another (authentication) application during an OOB challenge to your application once the challenge is successfully completed. This feature allows for a seamless transition and improved user flow.

To enable this feature, ensure that you include the threeDsAppRequestorUrl parameter when configuring the PrimerThreeDsOptions object.

Please note that the threeDsAppRequestorUrl value must be a Android App Link. Additionally, it is essential that your application is configured to handle the App Link properly in order to facilitate the redirection.

To configure the App Link correctly using Universal Checkout, follow these steps:

123456789101112131415161718

<activity  android:name="io.primer.android.threeds.ui.ThreeDsActivity"  android:exported="true"  tools:node="merge">  <intent-filter    android:autoVerify="true"    tools:targetApi="m">    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />    <category android:name="android.intent.category.BROWSABLE" />
    <data      android:host="{yourdomain.com}"      android:pathPrefix="/3ds"      android:scheme="https" />  </intent-filter></activity>

1. 3
   Replace the value of android:host with your web domain name, ensuring not to modify any other configuration
2. 4
   Once you've made the necessary changes, verify the App Link configuration by following the guidelines provided in the Android documentation.
3. 5
   Pass your App Link (e.g. https://{yourdomain.com}/3ds) as threeDsAppRequestorUrl in the PrimerThreeDsOptions object of your settings.

1234567

val settings = PrimerSettings(  // ...  paymentMethodOptions = PrimerPaymentMethodOptions(    threeDsOptions = PrimerThreeDsOptions("https://{yourdomain.com}/3ds")  )  // ...)

Execute 3D Secure

Universal Checkout drop-in and headless automatically render the 3DS challenge when required by your workflow.

If your application is not installed from a trusted source (e.g. a debug version, not installed from the store, or used on an emulator), try to set PrimerDebugOptions.is3DSSanityCheckEnabled to false. Otherwise 3D Secure library initialization will fail due to security checks being performed.