3DS execution enrollment

POST

Enroll a merchant in Forter's 3DS execution services on their future orders. The response will include a request ID that can be used to check on the status.

Credentials

HTTP Basic: basicAuth

Path Parameters

• id
  string

Header Parameters

• api-version
  string
• x-forter-siteid
  string

Body Parameters

• body
  threeDsExecutionOnboardingRequest

Description

Enroll a merchant in Forter's 3DS execution services on their future orders. The response will include a request ID that can be used to check on the status.

offerings
ThreeDsOfferings
*

threeDsConfiguration
ThreeDsConfiguration
*

Responses

200
Example: threeDsExecutionOnboardingRequestAccepted

Description: Response structure for merchant onboarding requests

• requestId
  string
• status
  string

400
Bad Request (Often missing a required parameter)

401
Unauthorized (No valid API key provided)

404
Not Found (The requested item doesn't exist)

500
Server Error (Something went wrong on Forter's end)

Request

Curl

curl --request POST \
--url https://api.forter-secure.com/merchants/{id}/3ds-execution \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'api-version: 10.1' \
--header 'x-forter-siteid: a1b2c3d4e5f6' \
--data '{\n   "offerings": {\n      "jp_regulation": {\n         "acquirer_settings": [\n            {\n               "acquirer": "Acquirer Name",\n               "scenario": "3DS_HIGH_RISK_S1"\n            }\n         ],\n         "enabled": true\n      },\n      "policy_3ds": true,\n      "psd2": true,\n      "risk_3ds": true\n   },\n   "threeDsConfiguration": {\n      "processors": [\n         {\n            "id": "",\n            "mids": [\n               {\n                  "acquirerId": "",\n                  "acquirerMerchantName": [\n                     {\n                        "cardScheme": "VISA",\n                        "value": "string"\n                     }\n                  ],\n                  "acquirerMid": "123456789",\n                  "merchantCategoryCode": "5661",\n                  "merchantEntityCountryNumericCode": "840",\n                  "requestorId": [\n                     {\n                        "cardScheme": "VISA",\n                        "value": "string"\n                     }\n                  ],\n                  "requestorName": [\n                     {\n                        "cardScheme": "VISA",\n                        "value": "string"\n                     }\n                  ],\n                  "requestorUrl": [\n                     {\n                        "cardScheme": "VISA",\n                        "value": "string"\n                     }\n                  ]\n               }\n            ]\n         }\n      ]\n   }\n}'

Responses

200

// Example threeDsExecutionOnboardingRequestAccepted
{\n   "requestId": "my-request-id-1234",\n   "status": "success"\n}