客户认证

POST /v1/mid-open-api/merchant/certification/submit
需要验证签名

接口描述

客户认证KYC信息提交。

提示

接口接受请求同步校验参数，最终KYC审核结果通过异步回调通知业务方，业务方也可主动查询获取。
证件照片，手持照片，代理人授权书等资料先调用上传接口获取fileId 【点击获取】
该接口只用作KYC提交，当审核失败时需调用KYC更新接口更新相关材料
同一主体(customer_location+customer_type)下证件号不可重复
customer_location目前只支持CN，HK

请求头

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

请求参数

Request:

Parameter	Type	Required	Description
client_id	string(64)	M	PP用户唯一ID
customer_location	enum	M	公司注册或个人所在地【取值请见附录】
customer_type	enum	M	客户类型【取值请见附录】
name	string(255)	M	客户或公司名称
certificate_info_list	array	M	证件信息列表
handheld_id	string(64)	C	手持证件照片file_id(和认证结果二选一,客户类型为企业时填法人手持证件照片,个人类型时填个人手持证件照片)
face_identification	enum	C	认证结果(和手持证件照片二选一,客户类型为企业时填法人认证结果,个人类型时填个人认证结果) 目前只支持PASS 【取值请见附录】
legal_person_info	object	C	法人信息 (客户类型为企业必填)
ubo_info_list	array	C	ubo信息（客户类型为企业必填,仅需填写持股比例大于等于25%的最终受益人信息）
agent_info	object	O	代理人信息 (客户类型为企业可选填，个人类型无需填写)
business_type_list	array	M	业务类型【取值请见附录】个人类型只能为ECOMMERCE_PLATFORM
extra_info	string(2048)	C	json拓展字段，业务类型为B2B_COMMERCE或SELF_STATION时必填

certificate_info_list:

Parameter	Type	Required	Description
id_front	string(64)	M	证件人像页file_id或企业证件正面照
id_back	string(64)	C	证件国徽页file_id(大陆身份证必填)
id_type	enum	M	证件类型【取值请见附录】
id_number	string(64)	M	证件号码

legal_person_info:

Parameter	Type	Required	Description
nation	enum	M	国籍(CN:中国大陆 HK:香港等)
name	string(255)	M	姓名
id_front	string(64)	M	证件人像页file_id
id_back	string(64)	C	证件国徽页file_id(大陆身份证必填)
id_type	enum	M	证件类型【取值请见附录】
id_number	string(64)	M	证件号码

ubo_info_list:

Parameter	Type	Required	Description
nation	enum	M	国籍(CN:中国大陆 HK:香港等)
name	string(255)	M	姓名
id_front	string(64)	M	证件人像页file_id
id_back	string(64)	C	证件国徽页file_id(大陆身份证必填)
id_type	enum	M	证件类型【取值请见附录】
id_number	string(64)	M	证件号码
order_index	Integer(max=4)	M	股东信息排列序号,从0开始编号递增，不允许重复

agent_info:

Parameter	Type	Required	Description
nation	enum	M	国籍(CN:中国大陆 HK:香港等)
name	string(255)	M	姓名
id_front	string(64)	M	证件人像页file_id
id_back	string(64)	C	证件国徽页file_id(大陆身份证必填)
id_type	enum	M	证件类型【取值请见附录】
id_number	string(64)	M	证件号码
loa	string(64)	M	企业代理人授权书(先调用上传接口上传授权书)

extra_info:

Parameter	Type	Required	Description
main_product	string(64)	M	主营产品
export_country_list	array	M	出口国家例如点击获取
company_url	string(128)	M	公司网址

返回响应

Parameter	Type	Required	Description
kyc_status	string	M	【取值请见附录】

返回示例

成功
失败

{
    "code": 200,
    "message": "SUCCESS",
    "data": {
      "kyc_status": "PENDING"
    }
}

{
  "code": 901010,
  "message": "user not exist",
  "data": null
}

错误码

返回码	描述	解决方案
900000	system error	系统错误，请联系PingPong技术人员核查
900002	illegal param	参数有误，请根据提示更正信息
910001	user not exist	client_id不存在，请核对后再发起
911000	id_number already exist	证件号已存在，请更正后再发起
911003	kyc already exist	KYC已存在，不允许重复提交

附录

card_type【证件类型】

值	描述	个人/企业
CN_IDENTITY_CARD	大陆身份证	个人
HK_ID_CARD	香港身份证	个人
PASSPORT	护照	个人
RESIDENCE_PERMIT	港澳台居住证	个人
MAINLAND_TRAVEL_PERMIT	大陆通行证	个人
HK_BUSINESS_LICENCE	商业登记证	香港企业必填
COI	公司注册说明书	香港企业必填
BUSINESS_LICENCE	营业执照影印件	大陆企业必填

customer_location【客户所在地】

值	描述
CN	中国大陆
HK	香港

customer_type【客户类型】

值	描述
ENTERPRISE	企业
INDIVIDUAL	个人

kyc_status【审核状态】

值	描述
PENDING	待审核
APPROVED	审核通过
DECLINED	审核拒绝

business_type【业务类型】

值	描述
B2B_COMMERCE	一般贸易
ECOMMERCE_PLATFORM	电商平台
SELF_STATION	独立站

face_identification【认证结果】

值	描述
PASS	通过

接口描述​

请求头​

请求参数​

返回响应​

返回示例​

错误码​

附录​

card_type【证件类型】​

customer_location【客户所在地】​

customer_type【客户类型】​

kyc_status【审核状态】​

business_type【业务类型】​

face_identification【认证结果】​

接口描述

请求头

请求参数

返回响应

返回示例

错误码

附录

card_type【证件类型】

customer_location【客户所在地】

customer_type【客户类型】

kyc_status【审核状态】

business_type【业务类型】

face_identification【认证结果】