支付宝实名认证申请

1、修订记录

修订记录 日期 说明
1.0 2022.10.24 初版

2、业务说明

（1）接口说明

场景：用于支付宝交易做实名认证，提交实名认证申请。  

注意：本接口中的图片需要传URL，例如：group1,M00/26/0D/CtUiIlYg-AcTmgAAU2krJ8NgE60.jpeg，具体获取方式详见 文件上传接口。

请求主体类型：application/json

请求方式：POST

3、请求地址

环境 HTTPS请求地址
测试环境 https://appdev.ysepay.com/openapi/pregate/alipay/submitAuthMessages
正式环境 https://ysgate.ysepay.com/openapi/pregate/alipay/submitAuthMessages

4、请求参数说明

4.1、公共请求参数

参数 类型(长度） 必填 参数说明
timeStamp String Y 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"
method String(128) Y 接口名称，固定值：pregate.alipay.submitAuthMessages
charset String(10) Y 请求使用的编码格式，如utf-8,gbk,gb2312等,固定为utf-8
sign String Y 商户请求参数的签名串（签名算法默认为国密）,详见demo,注意:请用商户私钥进行签名
check String Y 银盛公钥加密随机生成的字符串（key）得到的加密值，详见demo
bizContent String Y 业务参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递。注意：需要通过AES以及随机生成的字符串（key）加密业务参数集合，得到bizContent
reqId String Y 请求唯一流水号,商户系统唯一，要求32个字符内（最少14个字符），只能是数字、大小写字母_-且在同一个商户号下唯一。最后12位要求格式为"yyMMddHHmmss" 示例值：xy1415220315145602
certId String Y 发起方商户号，服务商在银盛给自己开设的商户号，即可当作发起方商户号，由银盛生成并下发。 注意：不同于子商户号，服务商发展的商户即为子商户号
version String Y 调用的接口版本，固定为：1.0

4.2、业务请求参数

（bizContent加密前的json数据明文字符串）

参数 类型(长度） 必填 参数说明
mercId String(20) Y 商户号
mercName String(128) N 开户意愿确认商户名称
contactCorpId String(20) Y 联系人证件号码
contactsTel String(20) Y 联系人证件手机号
idHolderType String N 证件持有人类型,类型值：LEGAL-经营者/法人 、SUPER-经办人，示例值：LEGAL。
注意：
 一、主体类型为政府机关、事业单位时选传：
（1）若上传的是法人证件，则不需要上传该字段。
（2）若因特殊情况，无法提供法人证件时，可上传经办人。
（3）经办人：经商户授权办理支付宝支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证。
 二、主体类型为企业、个体户、社会组织时，默认为经营者/法人，不需要上传该字段。
idValidDateBegin String N 法人证件有效开始日期,格式：yyyy-MM-dd，例：2001-12-31
idValidDateEnd String N 法人证件有效结束日期,格式：yyyy-MM-dd，若为永久，此时间为2999-12-31
busLincenceBegin String N 营业执照有效开始日期,格式：yyyy-MM-dd，例：2001-12-31
busLincenceEnd String N 营业执照有效结束日期,格式：yyyy-MM-dd，若为永久，此时间为2999-12-31
managementType String N 小微经营类型,00-门店场所、01-流动经营/便民服务。
storeName String(128) N 门店名称
shopPhoto String(200) N 门头照,要求如下：
1、经营类型为00，提交门店门口照片，要求招牌清晰可见。
2、经营类型为01，提交经营/服务现场照片。
storeEnvirPhoto String(200) N 店内环境照片,要求如下：
1、经营类型为00，提交店内环境照片。
2、经营类型为01，可提交另一张经营/服务现场照片。
linencePhoto String N 营业执照营业执照复印件,营业执照营业执照复印件(盖公章)
indentityPhoto String N 法人身份证复印件,法人身份证复印件（盖私章，签字）/原件扫描件
protocolPhoto String N 服务协议复印件,服务协议复印件（盖公章）/原件扫描件
cocc String N 组织机构代码证,组织机构代码证（盖公章）/原件扫描件
sfzbackphoto String N 法人身份证反面照
sfzfrontphoto String N 法人身份证正面照
grantAuth String N 法定代表人授权函,当证件持有人类型为"经办人"时，必须上传。其他情况，无需上传。
idImgHand String N 手持身份证
bankCardImg String N 银行卡照片或开户许可证
bdShopPhoto String N BD与门头照合影
bdPosterPhoto String N BD与门店摇摇乐海报合影
wxPlatform String N 平台入驻照片(支付宝)
unitPhoto String N 单位函
bookType String N 证书类型,类型如下：
CERTIFICATE_TYPE_2388-事业单位法人证书
CERTIFICATE_TYPE_2389-统一社会信用代码证书
CERTIFICATE_TYPE_2390-有偿服务许可证（军队医院适用)
CERTIFICATE_TYPE_2391-医疗机构执业许可证（军队医院适用)
CERTIFICATE_TYPE_2392-企业营业执照（挂靠企业的党组织适用)
CERTIFICATE_TYPE_2393-组织机构代码证（政府机关适用)
CERTIFICATE_TYPE_2394-社会团体法人登记证书
CERTIFICATE_TYPE_2395-民办非企业单位登记证书
CERTIFICATE_TYPE_2396-基金会法人登记证书
CERTIFICATE_TYPE_2397-慈善组织公开募捐资格证书
CERTIFICATE_TYPE_2398-农民专业合作社法人营业执照
CERTIFICATE_TYPE_2399-宗教活动场所登记证
CERTIFICATE_TYPE_2400-其他证书/批文/证明
hotLine String N 客服电话
merContactType String Y 联系人类型,65-经营者/法人、66-经办人，示例值：65。
当商户主体为小微商户时，无需填写,只能选择 65；
主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择 65 或者 66）
idTypeCd String Y 联系人证件类型,00-身份证、04-户口簿、06-外国护照、07-港澳通行证、08-台胞通行证。
若联系人类型为“法人”，则该姓名需与法人代表证件类型一致。
若联系人类型为“经办人”，则可填写实际经办人的证件类型。
idFrontImg String N 联系人证件证面照片,联系人为经办人时必填，类型为其他国家或地区居民-护照，此项选填。
idBackImg String N 联系人证件反面照片,联系人为经办人时必填，类型为其他国家或地区居民-护照，此项选填。
busAutLetterImg String N 业务办理授权函,可不填。
contDateBegin String N 联系人证件有效期开始时间,格式 yyyy-MM-dd
contDateEnd String N 联系人证件有效期结束时间,格式 yyyy-MM-dd，若为永久，此时间为2999-12-31
financeType String N 金融机构类型,类型如下：
BANK_AGENT-银行业（适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等）；
PAYMENT_AGENT-支付机构（适用于非银行类支付机构）；
INSURANCE-保险业（适用于保险、保险中介、保险代理、保险经纪等保险类业务）；
TRADE_AND_SETTLE-交易及结算类金融机构（适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等）；
OTHER-其他金融机构；
更多见：https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.html
financeLicensePics Array N 金融机构许可证图片,当商户报备接口填入的mchType为230金融机构时，此项必填。
最多可支持5张
specialOperations Array N 经营许可证列表
beneficiarys Array N 受益人列表,仅企业需要填写。若经营者/法人不是最终受益所有人，则需提填写受益所有人信息(目前支持一个)

4.2.1 specialOperations具体参数

参数 类型(长度） 必填 参数说明
categoryId String N 行业ID,参考：https://kf.qq.com/faq/220228quYbQJ220228qiiYZF.html
operationCopyList Array N 行业经营许可证资质照片,行业经营许可证资质照片（每个行业最多支持6张资质照片）

4.2.2 beneficiarys具体参数

参数 类型(长度） 必填 参数说明
uboIdType String Y 证件类型,00-身份证、04-户口簿、06-外国护照、07-港澳通行证、08-台胞通行证。
uboIdCardCopy String Y 身份证人像面照片
uboIdCardNational String Y 身份证国徽面照片
uboName String Y 受益人姓名
uboIdNumber String Y 证件号码
address String Y 证件居住地址
uboIdCardValidDateBegin String Y 证件有效日期开始日期,格式：yyyy-MM-dd
uboIdCardValidDateEnd String Y 证件有效日期结束日期,格式：yyyy-MM-dd

5、响应参数说明

请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。

5.1、公共响应参数

参数 类型(长度） 必填 参数说明
code String(5) Y 网关响应码，示例值：00000 ，详见网关公共响应码
msg String(50) Y 网关响应码描述
subCode String Y 业务响应码，参见具体的API接口文档
subMsg String Y 业务响应描述
timeStamp String Y 响应时间，格式"yyyy-MM-dd HH:mm:ss"
norce String(128) Y 随机参数
sign String Y 响应参数的签名串，详见demo,
注意:请用银盛公钥进行验签
businessData String Y 业务响应参数集合，
注意：银盛网关通过AES加密业务响应参数集合，得到businessData，商户需要对其进行解密，详情请见demo

5.2、业务响应参数

响应业务参数businessData(json数据)

参数 类型(长度） 必填 参数说明
reqMsgId String N 请求流水号
sendChannelApplyNo String N 实名认证申请单单号,该单号用于查询实名认证结果

6、业务响应码 网关公共响应码

响应码 响应码描述 解决方案
0000 成功
9999 失败 系统异常，请稍后使用相同的参数继续调用
5000 超时 业务系统超时，请稍后使用相同的参数继续调用
A029998 非法参数 请根据接口返回的详细信息检查请求参数
9900 查询不到报备信息 检查请求参数，修改后重新发起请求
B059900 业务错误 请根据接口返回的详细信息检查

results matching ""

    No results matching ""