微信实名认证明细信息查询

1、修订记录

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

2、业务说明

（1）接口说明

详细信息查询

请求主体类型：application/json

请求方式：POST

3、请求地址

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

4、请求参数说明

4.1、公共请求参数

参数	类型(长度）	必填	参数说明
timeStamp	String	Y	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"
method	String(128)	Y	接口名称，固定值：trade.scan.wechat.getAuthMessagesByMercId
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	商户号

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：失败,具体含义见全局中的状态码
sendChannelAuthApplyId	String	N	实名认证申请单编号,银盛系统生成的申请单编号
applyStatus	String	N	申请单审核状态, 申请单审核状态： 00-审核中 01-待确认联系信息 02-待账户验证 03-审核通过 04-审核驳回 05-冻结 06-已作废 07-申请单提交失败示例：00
qrcodePic	String	N	小程序码图片,fastDfs上的图片地址
qrcodeData	String	N	小程序码图片,base64编码
outMercIdAuthStatus	String	N	授权状态,第三方商户号授权状态
outMercIdRemark	String	N	授权状态备注,第三方商户号授权状态备注
authTime	String	N	授权认证时间,格式：yyyyMMddHHmmss
channelReturnAuthApplyId	String	N	渠道申请单编号,渠道返回实名认证申请单编号

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

响应码	响应码描述	解决方案
0000	成功
9999	失败	系统异常，请稍后使用相同的参数继续调用
5000	超时	业务系统超时，请稍后使用相同的参数继续调用
A029998	非法参数	请根据接口返回的详细信息检查请求参数
A029994	系统异常	系统异常，请稍后使用相同的参数继续调用

results matching ""

No results matching ""