3DS Server Integration Manual

Web Service API

3DSecure API

The 3DS Server web services are mapped under /3ds and handle HTTP POST requests. I.e. to initiate authentication, post your request to /3ds/authentication.

The 3DS Server provides two web service operations to support 3-D Secure transactions:

Operation Request Response Description
versioning ThreeDSServerVersioningRequest ThreeDSServerVersioningResponse Invoke 3DS Method Versioning.
authentication ThreeDSServerAuthenticationRequest ThreeDSServerAuthenticationResponse Initiate authentication.
challenge-cancelled Challenge Cancelled Request empty response Notify about challenge cancelled

The 3DS Server web service operations can consume/produce the following media types:

  • application/json

    When calling the web service, specify the media type of your content using the Content-Type HTTP header.

    Refer to the 3DS Server API documentation for details.

Additionally, the 3DS Server will send requests to the 3DS Requestor, if available, for the following operations:

Operation Request Description
results ThreeDSServerResultsResponse Send the Results Response to the Requestor domain
challenge ThreeDSServerChallengeResponse Send the final Challenge Response to the Requestor domain

The 3DS Server does not require confirmation of the received data from the Requestor, so no data should be returned. The Requestor should ensure that the configured Requestor endpoints are valid and accessible by the 3DS Server. Refer to the 3DS Server API documentation for details.