> 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.md).

# KYC API

创建身份认证用户、获取认证链接并查询 KYC 状态。

{% hint style="warning" %}
**未上线（文档预览）**：KYC OpenAPI 尚未在生产环境上线。本文档仅供接入方案预研，接口定义与业务规则在正式发布前可能调整。请勿用于生产业务；测试接入请联系 MusePay 确认可用性与开通安排，正式可用时间以发布通知为准。
{% endhint %}

KYC API 面向已开通独立身份认证产品的商户，提供托管式身份认证流程。使用前请联系 MusePay 确认目标环境的可用性、已开通档位、费用和商户回调地址。

## 接口

| 接口                                                                  | 路径                              | 说明                           |
| ------------------------------------------------------------------- | ------------------------------- | ---------------------------- |
| [创建认证用户](/cn/api-can-kao/api-reference/kyc-api/create-applicant.md) | `POST /v1/kyc/applicant/create` | 创建或获取商户名下的认证用户。              |
| [获取认证链接](/cn/api-can-kao/api-reference/kyc-api/link.md)             | `POST /v1/kyc/link`             | 发起一次收费认证申请，返回托管认证链接。         |
| [查询 KYC 状态](/cn/api-can-kao/api-reference/kyc-api/query.md)         | `POST /v1/kyc/query`            | 查询用户最近一次认证申请的档位、状态及已获得的认证等级。 |

三个接口均需要[通用参数](/cn/api-can-kao/api-reference/common-parameters.md)和商户请求签名。各页请求示例仅展示业务字段，不能直接作为完整请求发送。

## 相关文档

* [KYC 集成指南](/cn/ji-cheng/kyc-api.md)：开通、档位、收费和完整流程。
* [KYC 商户回调](/cn/ji-cheng/webhook/kyc.md)：最终结果通知与安全注意事项。