# 客户接口/客户KYC认证

## 业务场景是否KYC通过

> version=0.0.1\
> bizType=customer.app.KycWebApiService.checkKycApply\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.checkKycApply":{"post":{"summary":"业务场景是否KYC通过","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.checkKycApply\n登录之后可以访问","operationId":"checkKycApply","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"businessCode":{"type":"string","description":"业务场景code，开户=open_account，入金=cashin，取款=withdraw，信用卡=apply_credit_card"}},"required":["businessCode"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"KYC拒绝原因"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"integer","description":"正常2=成功，异常状态【0认证，1审核中，3审核拒绝】"},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## 获取业务场景KYC认证信息

> version=0.0.1\
> bizType=customer.app.KycWebApiService.findAllBizKyc\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.findAllBizKyc":{"post":{"summary":"获取业务场景KYC认证信息","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.findAllBizKyc\n登录之后可以访问","operationId":"findAllBizKyc","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"businessCode":{"type":"string","description":"业务场景code，开户=open_account，入金=cashin，取款=withdraw，信用卡=apply_credit_card"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业"}},"required":["businessCode"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResultListKycAuthVO"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResultListKycAuthVO":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"array","description":"数据体","items":{"$ref":"#/components/schemas/KycAuthVO"}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}},"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"等级code"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"levelName":{"type":"string","description":"等级名称"},"pathName":{"type":"string","description":"KYC路径名称"},"pathCode":{"type":"string","description":"KYC路径code"},"elementList":{"type":"array","description":"KYC信息列表","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC元素code"},"elementName":{"type":"string","description":"KYC元素名称"},"showType":{"type":"string","description":"KYC元素显示类型"},"extend":{"type":"string","description":"KYC元素扩展属性"},"elementValue":{"type":"string","description":"KYC元素值"},"elementValueInputGroup":{"type":"string","description":"KYC元素值，组合"},"elementCodeInputGroup":{"type":"string","description":"KYC元素code，组合"}}}}}}
```

## 身份认证列表

> version=0.0.1\
> bizType=customer.app.KycWebApiService.findAllBizKycList\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.findAllBizKycList":{"post":{"summary":"身份认证列表","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.findAllBizKycList\n登录之后可以访问","operationId":"findAllBizKycList","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"array","description":"数据体","items":{"type":"object","properties":{"levelCode":{"type":"string","description":"KYC等级code"},"levelName":{"type":"string","description":"KYC等级名称"},"status":{"type":"integer","format":"int32","description":"认证状态,0认证，1审核中，2审核通过，3审核拒绝"},"statusName":{"type":"string","description":"认证状态名称,0认证，1审核中，2审核通过，3审核拒绝"},"sort":{"type":"integer","format":"int32","description":"排序"},"preLevelName":{"type":"string","description":"前置等级信息"},"businessNameList":{"type":"array","description":"业务场景名称集合","uniqueItems":true,"items":{"type":"string"}},"businessCodeList":{"type":"array","items":{"type":"string"},"description":"业务场景code集合"},"companyType":{"type":"string","description":"企业类型 "},"openAccountType":{"type":"string","description":"开户类型：0.个人 1.企业 "},"pathCode":{"type":"string","description":"认证路径"}}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## 根据业务场景获取客户已经认证信息

> version=0.0.1\
> bizType=customer.app.KycWebApiService.findAllCusKycListByBiz\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.findAllCusKycListByBiz":{"post":{"summary":"根据业务场景获取客户已经认证信息","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.findAllCusKycListByBiz\n登录之后可以访问","operationId":"findAllCusKycListByBiz","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"businessCode":{"type":"string","description":"业务场景code，开户=open_account，入金=cashin，取款=withdraw，信用卡=apply_credit_card"}},"required":["businessCode"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResultListKycAuthVO"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResultListKycAuthVO":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"array","description":"数据体","items":{"$ref":"#/components/schemas/KycAuthVO"}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}},"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"等级code"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"levelName":{"type":"string","description":"等级名称"},"pathName":{"type":"string","description":"KYC路径名称"},"pathCode":{"type":"string","description":"KYC路径code"},"elementList":{"type":"array","description":"KYC信息列表","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC元素code"},"elementName":{"type":"string","description":"KYC元素名称"},"showType":{"type":"string","description":"KYC元素显示类型"},"extend":{"type":"string","description":"KYC元素扩展属性"},"elementValue":{"type":"string","description":"KYC元素值"},"elementValueInputGroup":{"type":"string","description":"KYC元素值，组合"},"elementCodeInputGroup":{"type":"string","description":"KYC元素code，组合"}}}}}}
```

## KYC等级是否要KYC认证

> version=0.0.1\
> bizType=customer.app.KycWebApiService.findAllLevelKyc\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.findAllLevelKyc":{"post":{"summary":"KYC等级是否要KYC认证","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.findAllLevelKyc\n登录之后可以访问","operationId":"findAllLevelKyc","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string","description":"语言信息"},"levelCode":{"type":"string","description":"KYC等级(\tlevel_1,level_2,\tlevel_3)"},"customerNo":{"type":"string","description":"客户账号(每个公司下唯一，跨公司不唯一)"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"selectCountry":{"type":"string","description":"选择的国家"},"selectCompanyType":{"type":"string","description":"选择的企业类型"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResultListKycAuthVO"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResultListKycAuthVO":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"array","description":"数据体","items":{"$ref":"#/components/schemas/KycAuthVO"}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}},"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"等级code"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"levelName":{"type":"string","description":"等级名称"},"pathName":{"type":"string","description":"KYC路径名称"},"pathCode":{"type":"string","description":"KYC路径code"},"elementList":{"type":"array","description":"KYC信息列表","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC元素code"},"elementName":{"type":"string","description":"KYC元素名称"},"showType":{"type":"string","description":"KYC元素显示类型"},"extend":{"type":"string","description":"KYC元素扩展属性"},"elementValue":{"type":"string","description":"KYC元素值"},"elementValueInputGroup":{"type":"string","description":"KYC元素值，组合"},"elementCodeInputGroup":{"type":"string","description":"KYC元素code，组合"}}}}}}
```

## 获取支持企业开户的国家

> version=0.0.1\
> bizType=customer.app.KycWebApiService.findCompanyCountry\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.findCompanyCountry":{"post":{"summary":"获取支持企业开户的国家","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.findCompanyCountry\n登录之后可以访问","operationId":"findCompanyCountry","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","description":"数据体","properties":{"openCompanyCountry":{"type":"string","description":"支持企业开户国家（对应国家code）"}},"required":["openCompanyCountry"]},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## KYC业务场景认证申请

> version=0.0.1\
> bizType=customer.app.KycWebApiService.kycApply\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.kycApply":{"post":{"summary":"KYC业务场景认证申请","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.kycApply\n登录之后可以访问","operationId":"kycApply","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"levelCode":{"type":"string","description":"KYC等级Code(level_1,level_2,level_3)"},"businessCode":{"type":"string","description":"业务场景code，开户=open_account，入金=cashin，取款=withdraw，信用卡=apply_credit_card"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"elementList":{"type":"array","description":"KYC元素集合","items":{"$ref":"#/components/schemas/KycWebAddInnerDTO"},"maxItems":2147483647,"minItems":1},"selectCompanyType":{"type":"string","description":"选择的企业类型,企业认证时必填"},"commitTag":{"type":"boolean","description":"是否提交，默认提交"},"selectCountry":{"type":"string","description":"选择的国家,企业认证选填，空值取注册国家"},"cardType":{"type":"string","description":"卡类型","maxLength":50}},"required":["elementList"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"KycWebAddInnerDTO":{"type":"object","required":["elementCode","elementValue"],"properties":{"elementValue":{"type":"string","description":"KYC元素值"},"elementCode":{"type":"string","description":"KYC元素"}}},"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","description":"数据体","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## KYC等级认证申请

> version=0.0.1\
> bizType=customer.app.KycWebApiService.kycLevelApply\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/客户KYC认证"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.KycWebApiService.kycLevelApply":{"post":{"summary":"KYC等级认证申请","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.KycWebApiService.kycLevelApply\n登录之后可以访问","operationId":"kycLevelApply","tags":["客户接口/客户KYC认证"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"levelCode":{"type":"string","description":"KYC等级Code(level_1,level_2,level_3)"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"elementList":{"type":"array","description":"KYC元素集合","items":{"$ref":"#/components/schemas/KycWebAddInnerDTO"},"maxItems":2147483647,"minItems":1},"selectCountry":{"type":"string","description":"选择的国家,企业认证选填，空值取注册国家"},"selectCompanyType":{"type":"string","description":"选择的企业类型,企业认证时必填"},"commitTag":{"type":"boolean","description":"是否提交，默认提交"}},"required":["elementList"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"string","description":"对应kyc待审核提案id"},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycWebAddInnerDTO":{"type":"object","required":["elementCode","elementValue"],"properties":{"elementValue":{"type":"string","description":"KYC元素值"},"elementCode":{"type":"string","description":"KYC元素"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-cn.multimarkets.org/client-api/geng-duo-.../ke-hu-jie-kou-ke-hu-kyc-ren-zheng.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.