Learn how you can submit a payment authorisation with Adyen, using authentication data from a third-party 3D Secure 2 provider.
Before you begin
Before you can start accepting 3D Secure 2 authenticated transactions on browsers or in-app, make sure that you:
- Sign up for an Adyen test account at https://www.adyen.com/signup.
Get your API Key. Save a copy as you'll need it for API calls you make to the Adyen payments platform.
Get authentication data
Get the following data from your 3D Secure 2 provider. You will need these values when submitting a payment authorisation request to Adyen.
transStatusfrom the Authentication Response (
ARes), received after the device fingerprinting process.
transStatusfrom the Results Response (
RRes), received after the challenge flow is completed.
messageVersion: The value should be 2.1.0.
Send a payment authorisation request with 3D Secure 2 authentication data
Make a POST
/payments request and include an
mpiData object. Pass the authentication data to the following the fields:
authenticationValuefrom your 3D Secure 2 provider.
xid: This is the
threeDSServerTransIDfrom your 3D Secure 2 provider.
threeDSVersion: The value should be 2.1.0.
Sample request with mpiData
resultCodeif the payment authorisation was successful. Otherwise, see Result codes f or a complete list of values and the actions that you need to take.