The following describes the integration steps for Netvalve Standalone 3DS. Contact the Netvalve team to ensure the 3DS configuration steps have been followed, and you have credentials for the API authentication.
Flow
See below the required sequence of Netvalve 3DS API calls, and the iframes to be configured on the merchant sites. See the detailed description for each step below.
...
Integration steps
V2 Step 1: 3DS Initialisation Api
Initiate the 3DS flow by calling this API and receiving back a
redirectUrl of netvalve page to do Iframe Step if ACS else will get 3ds data directly.
Step 2: Create Device Data Collection Iframe and POST event listener
Setup a hidden iframe and wait for a POST message which contains a
transIDproperty.
Step V2 Step 3: 3DS Auth API Conditional
Using the
transIDcall the Auth API. If response showschallengeRequired, proceed to Step 4
V2 Step 4: ACS challenge and receive challenge result
Setup the ACS challenge using an iframe or page-redirect, and wait for completion.
V2 Step 5: 3DS Result APIConditional
After being notified that the challenge is complete, call the Result API to access 3DS values.
V2 Step 6: Add 3DS fields in Sale API
- Use the 3DS values in the request body of the Sale API
...
API status codes
Please refer to the document below for a list of API response codes and descriptions.
Swagger API documentation is also updated in the Netvale documentation link below
...