# 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**

```bash
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**

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