# Cardholder Document Upload

### POST Cardholder Document Upload

POST /api/mastercard/holderPhotoUpload.html

Document upload status: 1 - Upload successful, 2 - Upload failed

> Request Body

```
```

```json
{
  "holderId": "1234567890",
  "photoData": "https://pic.rmb.bdstatic.com/bjh/down/55ae8d25de40edd2eef89fb7f64ed644.png",
  "photoType": "3",
  "randomStr": "abcdef12345ssss67890ssss"
}
```

#### Request Parameters

| Name      | Type    | Required | Base64 Encoding | Field Name    | Description                                                                               |
| --------- | ------- | -------- | --------------- | ------------- | ----------------------------------------------------------------------------------------- |
| holderId  | string  | true     | none            | Cardholder ID | The ID of the cardholder                                                                  |
| photoType | integer | true     | none            | Type          | 1 - ID card front, 2 - ID card back, 3 - Passport, 5 - Proof of address, 8 - Facial photo |
| photoData | string  | true     | Y               | Photo Data    | Photo data (base64-encoded string, maximum 1MB)                                           |
| randomStr | string  | true     | none            | Randomstr     | A random string of 32 characters                                                          |

> Example Response
>
> 200 Response

```
```

```json
{
  "errMsg": "string",
  "uploadStatus": 0
}
```

#### Response Fields

| Name         | Type    | Required | Constraints | Description                              |
| ------------ | ------- | -------- | ----------- | ---------------------------------------- |
| errMsg       | string  | true     | none        | Status description                       |
| uploadStatus | integer | true     | none        | 1 - Upload successful, 2 - Upload failed |