Skip to content
Important

We have released a new version. Documentation for our latest version can be found here.

Last updated: 09 June 2026 | Change log

Android and iOS SDK

Use our native android SDK to improve issuer challenge display for 3DS2 and increase the chance of a frictionless authentication using mobile device data.

  1. Get started with our App SDK

  2. Get a JWT to initialize the SDK and perform device data collection

  3. Submit order and risk data for authentication. The 3DS flow ends here if no challenge is required (frictionless).

  4. Show the issuer challenge display using the native SDK and retrieve the authentication details to form part of the payment authorize request.

Note

Native mobile support is a new feature of 3DS2, for responses that are 3DS1 a webview is required for the challenge.


Visualize our 3DS API and see the flow of a 3DS authentication.

Cardinal/IssuersAccess 3DSMerchant BackendMerchant FrontendBrowserCardinal/IssuersAccess 3DSMerchant BackendMerchant FrontendBrowserIf no `dfReferenceId` (collectionReference) is provided or the issuer doesn't support 3DS2, the flow will use 3DS1 from here (always challenge)Use in payment authorization:-version-authenticationValue-eci-transactionIdClick PayPaydeviceDataInitialization requestdeviceDataInitialization responsedeviceDataCollection.jwtcardinal.init(jwt)ConsumerSessionIdData for authentication requestAuthentication requestAuthentication response
Cardinal/IssuersAccess 3DSMerchant BackendMerchant FrontendBrowserCardinal/IssuersAccess 3DSMerchant BackendMerchant FrontendBrowserIf no `dfReferenceId` (collectionReference) is provided or the issuer doesn't support 3DS2, the flow will use 3DS1 from here (always challenge)Use in payment authorization:-version-authenticationValue-eci-transactionIdClick PayPaydeviceDataInitialization requestdeviceDataInitialization responsedeviceDataCollection.jwtcardinal.init(jwt)ConsumerSessionIdData for authentication requestAuthentication requestAuthentication response

Next steps

Get started