In the European Economic Area (EEA) and UK, you must enable out-of-band (OOB) authentication for your users. To do this, you must register their device as an SCA device. The registration associates your user's device with their card.
This page explains how to register devices for SCA using Adyen's Authentication SDK. Follow these steps:
- Check SCA eligibility.
- Begin the device registration from your server.
- Authenticate cardholder.
- Register the device with the Authentication SDK.
- Finish the device registration from your server.
Requirements
Before you begin, take into account the following requirements, limitations, and preparations.
| Requirement | Description |
|---|---|
| Integration type | You must have an Adyen Issuing integration. |
| API credentials | Your API credential must have the Bank SCA Webservice Role. |
| Setup steps | You must have installed the Authentication SDK. |
| Limitations | The operating system on your user's device must support SCA. |
Check SCA eligibility
Before you perform any task involving SCA, you must first check if the device is eligible using the Authentication SDK. If the eligibility check is successful, the Authentication SDK provides an output that you must include in your API requests.
This functionality requires additional configuration from Adyen. To enable it, contact our Support Team.
You use the sdkOutput when you begin the device registration.
Begin the device registration
Registering the device is a one-off procedure for each device. If your user has multiple devices, you must register each one separately. After a device is registered, you can associate one or more entities to it. To learn how to associate entities with a registered device, go to Manage registered devices.
To start the device registration, follow the instructions in the tabs below:
Authenticate cardholder
In your client app, perform authentication. PSD2 requires you to perform two-factor authentication (2FA) as an extra security step during the login process.
Register the device with the Authentication SDK
To register the device with the Authentication SDK:
-
Authenticate the user by performing two-factor authentication (2FA).
-
Trigger the SDK to start the device registration and pass the sdkInput that you received when you began the device registration.
-
Pass
sdkOutputto your server.
You use the sdkOutput when you finish the registration.
Finish the device registration
To finish the device registration, follow the instructions in the tabs below: