实名认证状态查询
实名认证状态查询
接口描述:可通过该接口查询商户支付宝、微信实名认证信息
接口说明
适用对象:代理商
请求URL:https://pay.yintongzaixian.com/api/mchApplyment/realName/query
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
“必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
请求参数
| 参数名 | 中文名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|---|
| applyId | 申请单ID | Y | String | A1950440220066045954 | 进件发起后响应的申请单ID |
| queryType | 查询类型 | Y | String | 1 | 查询类型:1-微信 2-支付宝 |
| agentNo | 代理商号 | C | String | A3929388111 | 代理商发起时必填 |
| mchNo | 商户号 | Y | String | A3929388111 (代理商),M3929388111(商户号) | 代理商发起固定传入代理商号;若为商户主动发起则传入商户号; |
| appId | 应用APPID | Y | String | A3929388111,686b6f5b46c83837aebd1db2 | 代理商发起固定传入代理商号;若为商户主动发起则传入商户应用ID; |
| reqTime | 请求时间 | Y | String | 1622016572190 | 请求接口时间,13位时间戳 |
| version | 接口版本 | Y | String | 1.0 | 接口版本号,固定:1.0 |
| sign | 签名 | Y | String | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
| signType | 签名类型 | Y | String | MD5 | 签名类型,目前只支持MD5或RSA2方式 |
响应参数说明:
| 参数名 | 中文名 | 说明 |
|---|---|---|
| signUrl | 实名认证码 | 系统返回的支付宝/微信实名认证码 |
| imgType | 认证码图片类型 | 认证码格式类型:imgUrl、qrContent,可用img标签直接加载该图片。 |
| state | 认证状态 | 文字描述 |
| errInfo | 错误信息 | 失败等业务异常信息 |
请求示例:
{
"applyId": "A1951187263243825154",
"agentNo": "A1682391658",
"appId": "A1682391658",
"sign": "A1144E7281971619FA89DA2153F54CB8",
"signType": "MD5",
"reqTime": "1754445551041",
"mchNo": "A1682391658",
"version": "1.0",
"queryType": "2"
}
响应结果:
{
"code": 0,
"data": {
"imgType": "imgUrl",
"signUrl": "https://mobilecodec.alipay.com/show.htm?code=2ie12222cutvcwwhzie4f9",
"state": "待联系人确认;支付宝渠道号:2088734560325000"
},
"msg": "SUCCESS",
"sign": "2EAEF2A34D15A31B2722F0E21329D9F9"
}
SDK调用示例(Java):
JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchRealNameQueryRequest request = new ApplymentMchRealNameQueryRequest();
ApplymentMchRealNameQueryReqModel model = new ApplymentMchRealNameQueryReqModel();
model.setMchNo(Jeepay.mchNo); // 商户号
model.setAppId(jeepayClient.getAppId()); // 应用ID
model.setApplyId("A1951187263243825154"); // 申请单ID
model.setQueryType("2"); // 查询类型:1-微信 2-支付宝
request.setBizModel(model);
try {
ApplymentMchRealNameQueryResponse response = jeepayClient.execute(request);
_log.info("验签结果:{}", response.checkSign(Jeepay.apiKey));
if (response.isSuccess(Jeepay.apiKey)) {
_log.info("data:{}", response.getData());
} else {
_log.info("请求失败:mchNo={}, msg={}", Jeepay.mchNo, response.getMsg());
}
} catch (JeepayException e) {
_log.error(e.getMessage());
}