NDM Simulator Integration with the 3DS Server

3DS Server 2.x

Once the Netcetera Demo Merchant Simulator is up and running, the following endpoints of the NDM Simulator should be configured in the 3DS Server Timeout Configuration:

  • The Results Response Notification Url - fully-qualified-url-of-simulator/requestor/results-notification
  • The Notification Url - fully-qualified-url-of-simulator/requestor/challenge-notification
  • The ThreeDS Requestor Url - fully-qualified-url-of-simulator/shop

Scheme Directory Server configuration

Since the NDM Simulator simulates a Directory Server, Scheme(s) should be configured in the 3DS Server Configuration having the NDM Simulator endpoints as Directory Server endpoints.

For handling authentication requests the NDM Simulator exposes the following endpoint:

  • fully-qualified-url-of-simulator/ds/authentication

This endpoint should be configured as primary endpoint of the Directory Server (in the url property).

For handling preparation requests the NDM Simulator exposes the following endpoints (all simulate different responses):

  • fully-qualified-url-of-simulator/ds/valid-pres-configured-card-range-data
    • The returned Preparation Response includes the configured card ranges.
    • Query Parameters:
      • schemeId (optional) Filters the returned card ranges by scheme. Only card ranges matching the specified schemeId will be included.
      • forceFullCardRangesUpdate (optional, default: true) Forces a full card range update in the Preparation Response.
  • fully-qualified-url-of-simulator/ds/valid-pres-add-card-range-data
    • Generates a valid Preparation Response including card range data. If rangesCount is not provided, a default static response is returned. When rangesCount is specified, the response includes simulated card ranges based on provided parameters.
    • Query Parameters:
      • rangesCount (optional) Determines the number of new card ranges. If not specified, the response returns predefined card ranges with BINs 400000 and 500000, including only 16-digit card numbers.
      • bin (optional, default: 400000) Specifies the BIN.
      • panLength (optional, default 16) Sets the card length, with a default value of 16
      • numOfRangesPerElement (optional, default 1) Determines the number of card ranges per element.
      • forceFullCardRangesUpdate (optional, default: true) Forces a full card range update in the PRes response.
  • fully-qualified-url-of-simulator/ds/valid-pres-custom-card-range-data
    • Simulates a valid Preparation Response with generated card range data. This endpoint is functionally similar as valid-pres-add-card-range-data, additionally allowing to specify a custom action indicator.
    • Query Parameters:
      • actionInd (optional, default: A) Specifies the action indicator. Allowed values are: A (ADD), M (MODIFY), D (DELETE) and random (RANDOM).
      • rangesCount (optional, default: 10000) Determines the number of new card ranges.
      • bin (optional, default: 400000) Specifies the BIN.
      • panLength (optional, default 16) Sets the card length, with a default value of 16
      • numOfRangesPerElement (optional, default 1) Determines the number of card ranges per element.
      • forceFullCardRangesUpdate (optional, default: true) Forces a full card range update in the PRes response.
  • fully-qualified-url-of-simulator/ds/pres-error-request-validation-failed
    • The returned Preparation Response indicates validation error (invalid threeDSServerRefNumber) in the preparation request.
  • fully-qualified-url-of-simulator/ds/pres-error-request-missing-data
    • The returned Preparation Response indicates missing data in the preparation request.
  • fully-qualified-url-of-simulator/ds/pres-error-request-invalid-serial-num
    • The returned Preparation Response indicates invalid serial number in the preparation request.
  • fully-qualified-url-of-simulator/ds/pres-error-request-sent-messages-limit-exceeded
    • The returned Preparation Response indicates the limit is exceeded for sending preparation request messages.
  • fully-qualified-url-of-simulator/ds/valid-pres-delete-card-range-data
    • The returned Preparation Response includes the following card ranges having action indicator DELETE: [4000003000000000, 4000003999999999].
  • fully-qualified-url-of-simulator/ds/timeout-pres
    • The returned Preparation Response is returned with a timeout of 5 seconds.
  • fully-qualified-url-of-simulator/ds/invalid-pres-missing-data
    • The returned Preparation Response is empty.
  • fully-qualified-url-of-simulator/ds/valid-pres-card-range-data-file-url
    • The returned Preparation Response includes fully qualified URL of the DS File containing the Card Range Data for download if the cardRangeDataDownloadInd is Y in the Preparation Request, otherwise the returned Preparation Response will include some configured card ranges. This behavior is supported since 2.3.1 protocol version.

Any of the these endpoints could be configured as a preparation endpoint of the Directory Server (in the preparationUrl property).