# 3DS recommendation enrollment

## POST

Enroll a merchant in Forter's 3DS recommendation 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**  
  threeDsRecommendationOnboardingRequest  
  *

### Description

- **offerings**  
  ThreeDsOfferings  
  *

### Responses

#### 200

**Example threeDsRecommendationOnboardingRequestAccepted**  
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-recommendation \  
--header 'accept: application/json' \  
--header 'content-type: application/json' \  
--header 'api-version: 10.1' \  
--header 'x-forter-siteid: a1b2c3d4e5f6' \  
--data '{  
  "offerings": {  
    "jp_regulation": {  
      "acquirer_settings": [  
        {  
          "acquirer": "Acquirer Name",  
          "scenario": "3DS_HIGH_RISK_S1"  
        }  
      ],  
      "enabled": true  
    },  
    "policy_3ds": true,  
    "psd2": true,  
    "risk_3ds": true  
  }  
}'
```

### Responses

#### 200
```json
{
  "requestId": "my-request-id-1234",
  "status": "success"
}
```