商户进件查询
接口描述:代理商可通过该接口查询商户进件申请单状态
接口说明
适用对象:代理商
请求URL:https://pay.yintongzaixian.com/api/mchApplyment/income/query
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
“必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
请求参数
| 参数名 | 中文名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|---|
| applyId | 申请单ID | Y | String | A1950440220066045954 | 进件发起后响应的申请单ID |
| 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方式 |
响应参数说明:
| 参数名 | 中文名 | 说明 |
|---|---|---|
| agentNo | 代理商号 | 代理商号 |
| mchNo | 商户号 | 商户号 |
| appId | 商户支付应用ID | 商户支付配置对应的应用ID |
| applyId | 申请单ID | 发起进件成功后响应的申请单ID |
| ifCode | 进件渠道代码 | 发起进件的渠道代码 |
| state | 进件状态 | 1-审核中 2-进件成功 3-驳回待修改 4-待验证 5-待签约 6-签约完成 7-等待系统预审核 8-预审核拒绝 |
| errorMsg | 错误描述信息 | 进件失败返回的错误描述 |
请求示例:
{
"ifCode": "shengpay",
"applyId": "A1950440220066045954",
"agentNo": "A1682391658",
"sign": "E722DA143376B1D69B6A05FBA437A0CA",
"signType": "MD5",
"reqTime": "1753945877760",
"version": "1.0"
}
响应结果示例:
{
"msg": "SUCCESS", // 请求响应说明
"code": 0, // 请求响应码
"data": { // 响应结果
"ifCode": "shengpay", // 进件渠道代码
"applyId": "A1950440220066045954", // 申请单ID
"agentNo": "A1682391658", // 代理商号
"appId": "6883345446c81f673bc26a25", // 商户支付应用ID
"state": "3", // 进件状态
"mchNo": "M1753429075", // 商户号
"errorMsg": "LACK_PARAMS[证件图片正面不能为空,证件图片反面不能为空]" // 错误描述信息
},
"sign": "7627E9034C1D2CAE2CC21EC33619F01E"
}
SDK调用示例(Java):
JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchInComeQueryRequest request = new ApplymentMchInComeQueryRequest();
ApplymentMchInComeQueryReqModel model = new ApplymentMchInComeQueryReqModel();
model.setAgentNo("A1748575585"); // 代理商号
model.setMchNo(Jeepay.mchNo); // 商户号
model.setAppId(jeepayClient.getAppId()); // 应用ID
model.setApplyId("A1955515775041179649"); // 申请单ID
request.setBizModel(model);
try {
ApplymentMchInComeQueryResponse 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());
}