> For the complete documentation index, see [llms.txt](https://docs-cn.multimarkets.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-cn.multimarkets.org/client-api/geng-duo-.../ke-hu-jie-kou-ke-hu-kyc-ren-zheng.md).

# 客户接口/客户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元素"}}}}}}
```