Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Once the initialize API has been called, the response will indicate which flow to begin.

Please note, if the merchant’s 3DS Provider is Cardinal, Flow 3 is irrelevant.

Flow A: 3Ds complete

If the response contains ECI and CAVV values, the 3DS step is complete and the merchant can proceed to call the SALE api with these values.

Screenshot 2024-08-14 at 1.42.52 PM.png

See https://netvalve.atlassian.net/wiki/spaces/ND/pages/54395121/V2+Step+6%3A+Add+3DS+fields+in+Sale+API

Flow B: challenge required

If the threeDSProviderResponse has a status of ACS_REQUIRED (or alternatively, check for the challengeRequired property), redirect to the url provided in the redirectUrl property.

Screenshot 2024-08-14 at 1.46.47 PM.png

The user will land on a 3DS challenge page. After authenticating, the user will be redirected back to the merchantRedirectUrl which was provided by the merchant in the initialisation API request body.

From there, the merchant can extract the transID and use it to call the result API to get the result of the 3DS challenge, and retrieve the eci and cavv values required for the sale operation.

See:

https://netvalve.atlassian.net/wiki/spaces/ND/pages/54395064/V2+Step+4%3A+ACS+challenge+and+receive+challenge+result

V2 Step 5: 3DS Result API

https://netvalve.atlassian.net/wiki/spaces/ND/pages/54395121/V2+Step+6%3A+Add+3DS+fields+in+Sale+API

Flow C: device data collection required

If the initialization response has a status of INITIALIZED, it indicates that the merchant must perform device data collection inside a hidden iframe on the page.

Screenshot 2024-08-14 at 2.04.42 PM.png

The merchant must use the redirectUrl to setup a hidden iframe, and listen for a Post Message Event. If successful, proceed to call the Auth API.

The Auth API response will indicate 2 possible flows - Flow A and Flow B described above. The response structure and properties are exactly the same as the initialization response.

See:

V2 Step 2: Create Device Data Collection Iframe and POST event listener

V2 Step 3: 3DS Auth API

  • No labels