Skip to content

Manage DS settings

All the settings for card schemes supported by ActiveServer can be managed from the Directory Servers page under the Settings tab.

User Access

A user requires the System admin role to manage DS settings.

Directory Server - Settings tab

To edit a card scheme's settings:

Select the appropriate card scheme tab at the top of the page to display its details.


The following settings can be edited:

  • Cache refresh interval - interval in which the PRes cache refreshes for all available card schemes. The PReq/PRes messages are utilised by ActiveServer to cache information about the Protocol Version Numbers(s) supported by available ACSs, the DS, and also any URL to be used for the 3DS Method call. The data will be organised by card range as configured by a DS. The information provided on the Protocol Version Number(s) supported by ACSs and the DS can be utilised in the App-based, Browser-based and 3RI flows. It is a 3DS2 specification requirement that this exchanges happens at least once every 24 hours and at most every hour. (unit: hours)
  • 3DS Server Operator ID - DS assigned 3DS Server identifier. Each DS can provide a unique ID to each 3DS Server on an individual basis, usually during or at the end of the card scheme compliance process. Requirements for the presence of this field in the AReq and PReq messages are DS specific.
  • HTTPS listening port - port that AS is listening on for HTTPS communications during authentications. This value is read from the configuration file for the corresponding DS setting and is used to listen for RReq requests.
  • 3DS Server URL - fully qualified URL of the 3DS Server to which the DS will send the RReq message after the challenge has completed. URL is fully customisable to your environment/load balancing setup and can be different to the server external URL.


    The 3DS Server URL may have already been set when updating the External URL.


The following settings can be edited:

  • Preparation Response (PRes) - timeout interval for the PRes message
  • Authentication Response (ARes) - timeout interval for the ARes message

Server URLs

In the Server URLs section, the DS URLs can be input for the addresses of the card scheme DS.

The Default URL is used for AReq and PReq message communications with the DS provider.

The PReq URL can optionally be filled in if the DS provider has a separate PReq endpoint for those requests. If a value is entered in this field, it will override the Default URL. If this value is empty, ActiveServer will send PReq messages to the Default URL if it entered.