> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/cn/api-can-kao/api-reference/kyc-api/create-applicant.md).

# 创建认证用户

{% hint style="warning" %}
每个请求都必须包含[通用参数](https://docs.musepay.io/cn/api-can-kao/api-reference/common-parameters.md)。下面的示例仅展示业务字段。
{% endhint %}

<mark style="color:green;">`POST`</mark> `/v1/kyc/applicant/create`

在你的商户账户下登记一个认证用户。不收费，也还不涉及实名认证：在用户打开链接并提交资料之前，认证服务商那边不会建档。

## 请求 Body

| 名称          | 类型     | 必填 | 说明                                  |
| ----------- | ------ | -- | ----------------------------------- |
| request\_id | String | 是  | 本次请求的标识，每次取新值。                      |
| user\_xid   | String | 是  | 你系统内稳定的用户标识，在商户账户内唯一。后续链接和查询都用同一个值。 |
| email       | String | 是  | 用户邮箱，需符合邮箱格式。                       |
| user\_name  | String | 否  | 展示名称，缺省用 `user_xid`。这不是经证件核验的姓名。    |

## 请求示例

```json
{
  "request_id": "kyc-create-202610150001",
  "user_xid": "customer-0001",
  "email": "customer-0001@example.com",
  "user_name": "Example User"
}
```

## 响应 Body

以下字段位于 `data` 中。

| 名称          | 类型     | 说明                           |
| ----------- | ------ | ---------------------------- |
| request\_id | String | 本次请求的标识。                     |
| user\_xid   | String | 商户侧用户标识。                     |
| user\_id    | String | MusePay 用户 ID。请保存并与你自己的用户关联。 |

```json
{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyc-create-202610150001",
    "user_xid": "customer-0001",
    "user_id": "1000001"
  }
}
```

## 错误码

`209005` —— 该邮箱已被你账户下另一个 `user_xid` 使用。请换一个邮箱注册。

## 重复调用

同一 `user_xid` 已存在时返回原来的 `user_id`，已存的邮箱和姓名不会被更新。匹配依据是商户 + `user_xid`，与 `request_id` 无关，因此换新 `request_id` 并不能改资料。

下一步：[获取认证链接](https://docs.musepay.io/cn/api-can-kao/api-reference/kyc-api/link.md)。
