微信实名认证申请单提交

1、修订记录

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

2、业务说明

（1）接口说明

商户入网后，需要提交实名认证申请单，提交之后通过调用查询接口获取申请单状态，如果申请单通过可以获得小程序码，扫描小程序码完成实名认证
注意：重复提交申请单会撤销前一笔非终态申请单ps:提交申请单接口中的请求数据如果在报备时未填，则此处必填做补充，否则报错；
如果进件已填，此处填写可以做修改，不填不报错。

请求主体类型：application/json

请求方式：POST

3、请求地址

环境 HTTPS请求地址
测试环境 https://appdev.ysepay.com/openapi/trade/scan/wechat/auth/submitAuthMessages
正式环境 https://ysgate.ysepay.com/openapi/trade/scan/wechat/auth/submitAuthMessages

4、请求参数说明

4.1、公共请求参数

参数 类型(长度） 必填 参数说明
timeStamp String Y 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"
method String(128) Y 接口名称，固定值：trade.scan.wechat.auth.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 Y 商户号
mercName String N 商户名称,① 商户名称必须与商家营业执照上的名称一致
②若个体工商户营业执照没有商家名称或者名称为“”或者“**”，则商户名称应填 “个体户XXX”（XXX为营业执照上经营者姓名）
③若商家为小微商户，商户名称应填 “商户_XXX”（XXX为小微商户身份证上的姓名）
merContactType String Y 联系人类型,必填项，校验联系人与法人信息是否一致，一致的则为65：经营者/法人 ，不一致时，校验商户类型是否为个体、企业、事业单位、政府机关、社会组织，如不是则报错，如是则为66：经办人

1、主体为“小微/个人卖家”时，可选择：65：经营者/法人。
2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：65：经营者/法人、66：经办人。
idTypeCd String Y 联系人证件类型,证件类型：
00-身份证
04-户口薄
06-外国护照
07-港澳通行证
08-台胞通行证
示例：00
idFrontImg String N 联系人证件正面照片
idBackImg String N 联系人证件反面照片
contIdValidDateBegin String N 联系人证件有效期开始时间,格式 yyyy-MM-dd
contIdValidDateEnd String N 联系人证件有效期结束时间,格式 yyyy-MM-dd,若为永久，传2999-12-31
contactCorpType String N 联系人证件类型,只支持身份证 00：身份证；
contactCorpId String N 联系人证件号码
indentityPhoto String N 法人身份证复印件,（盖私章，签字），原件扫描件
sfzbackPhoto String N 法人身份证反面照
sfzfrontPhoto String N 法人身份证正面照
idImgHandPhoto String N 手持身份证
grantAuth String N 法定代表人授权函
idValidDateBegin String N 法人证件有效开始日期,格式：yyyy-MM-dd
idValidDateEnd String N 法人证件有效结束日期,若为永久，此时间为2999-12-31
idHolderType String N 法人证件持有人类型,1. 主体类型为政府机关、事业单位时选传：
（1）若上传的是法人证件，则不需要上传该字段。
（2）若因特殊情况，无法提供法人证件时，可上传经办人。
（经办人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。
2. 主体类型为企业、个体户、社会组织时，默认为经营者/法人，不需要上传该字段。
字典值：
LEGAL：经营者/法人
SUPER：经办人
idAddress String N 法人居住地址,企业商户必填。
busLincenceBegin String N 营业执照/证书有效开始日期,格式：yyyy-MM-dd
busLincenceEnd String N 营业执照/证书有效结束日期,若为永久，此时间为2999-12-31
managementType String N 小微经营类型,小微商户必填。
小微经营类型,00-门店场所、01-流动经营/便民服务。
storeName String N 门店名称,小微商户必填，根据managementType小微经营类型填写不同值。
小微经营类型为00时，填写门店名称；
小微经营类型为01时，填写经营/服务名称；
小微经营类型为02时，填写线上店铺名称；
shopPhoto String N 门头照,报备时未上送则必填。
根据managementType小微经营类型上传不同照片。
小微经营类型为00时，提交门店门口照片，要求招牌清晰可见；
小微经营类型为01时，提交经营/服务现场照片；
小微经营类型为02时，提交店铺首页截图；
storeEnvirPhoto String N 店内环境照片,报备时未上送则必填。
根据managementType小微经营类型上传不同照片。
小微经营类型为00时，提交店内环境照片；
小微经营类型为01时，可提交另一张经营/服务现场照片；
小微经营类型为02时，提交店铺管理后台截图
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-其他证书/批文/证明
示例：CERTIFICATE_TYPE_2389
unitPhoto String N 单位函照
linencePhoto String N 营业执照营业执照,需盖公章
protocolPhoto String N 服务协议复印件,（盖公章）/原件扫描件
coccPhoto String N 组织机构代码证,（盖公章）/原件扫描件
bankCardImgPhoto String N 银行卡照片或开户许可证
bdShopPhoto String N BD与门头照合影,BD与门头照合影
bdPosterPhoto String N BD与门店摇摇乐海报合影,BD与门店摇摇乐海报合影
wxPlatform String N 平台入驻照片(微信),平台入驻照片(微信)
hotLine String N 客服电话,客服电话
beneficiaryList Array N 受益人信息集合
busAutLetterImg String N 业务办理授权函,联系人类型为经办人时必填
specialOperationList Array N 经营许可证信息集合
financeType String N 金融机构类型,金融机构类型：
BANK_AGENT-银行业，适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等
PAYMENT_AGENT-支付机构，适用于非银行类支付机构
INSURANCE-保险业，适用于保险、保险中介、保险代理、保险经纪等保险类业务
TRADE_AND_SETTLE-交易及结算类金融机构，适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等
OTHER-其他金融机构
更多见：https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.html
示例：PAYMENT_AGENT
financeLicensePics Array N 金融机构许可证图片,最多可以上传5张照片

4.2.1 beneficiaryList具体参数

参数 类型(长度） 必填 参数说明
uboIdType String Y 证件类型,证件类型：<br/>00-身份证<br/>04-户口簿<br/>06-外国护照<br/>07-港澳通行证<br/>08-台胞通行证<br/>示例：00<br/>
uboIdNumber String Y 证件号码
uboIdCardCopy String N 身份证人像面照片
uboIdCardNational String N 身份证国徽面照片
uboName String N 受益人姓名
address String N 证件居住地址,<span style="color: rgb(24, 43, 80);">请按照证件上住址填写，若证件上无住址则按照实际址填写</span><br/>
uboIdCardValidDateBegin String N 证件有效期开始日期,<span style="color: rgb(24, 43, 80);">格式：yyyy-MM-dd</span><br/>
uboIdCardValidDateEnd String N 证件有效期结束日期,格式yyyy-MM-dd，若为永久，此时间为2999-12-31<br/><br/>

4.2.2 specialOperationList具体参数

参数 类型(长度） 必填 参数说明
categoryId String N 行业ID,参考：https://kf.qq.com/faq/220228quYbQJ220228qiiYZF.html
operationCopyList Array N 经营许可证资质

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 请求流水号, 同请求
state String N 交易状态, 错误码成功时响应 00：成功，99/ZA/ZB/ZC/ZD/ZZ：失败,具体含义见全局中的状态码
applyNo String N 申请单编号
sendChannelApplyNo String N 业务编号

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

响应码 响应码描述 解决方案
0000 成功
9999 失败 系统异常，请稍后使用相同的参数继续调用
5000 超时 业务系统超时，请稍后使用相同的参数继续调用
A029998 非法参数 请根据接口返回的详细信息检查请求参数
A029994 系统异常
9900 查询不到报备信息
B022011 发起方商户号和商户号的归属关系校验失败 请确认发起方和商户的关系后，重新提交请求。

results matching ""

    No results matching ""