签约查询
接口描述:代理商可通过该接口查询商户进件申请单签约信息
| 渠道代码 | 渠道名称 | 是否适用当前接口 | 申请单状态 | 说明 |
|---|---|---|---|---|
| shengpay | 盛付通 | Y | 2-进件成功 | 申请单状态:2-进件成功此时调用该接口进行签约。 |
接口说明
适用对象:代理商
请求URL:https://pay.yintongzaixian.com/api/mchApplyment/signInfo
请求方式: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方式 |
响应参数说明:
| 参数名 | 中文名 | 说明 |
|---|---|---|
| msg | 响应描述 | 请求响应描述 |
| code | 响应码 | 请求响应码 |
| data | 响应结果 | 请求正确响应结果 |
| signUrl | 签约地址 | 需要用户签约的地址 |
| state | 签约状态 | 签约的结果状态 |
| electronicContractNo | 合同编号 | 签约合同编号 |
| errInfo | 失败描述 | 签约失败信息描述 |
请求示例:
{
"ifCode": "shengpay",
"applyId": "A1950440220066045954",
"agentNo": "A1682391658",
"sign": "E722DA143376B1D69B6A05FBA437A0CA",
"signType": "MD5",
"reqTime": "1753945877760",
"version": "1.0"
}
data:响应结果示例:(shengpay-盛付通)
{
"msg": "SUCCESS",
"code": 0,
"data": {
"signUrl": "https://sass.shengpay.com/esign/ca/71d40F9d1h2154899704", // 签约地址url
"state": "待签约", // 签约状态
"electronicContractNo": "E2025080160342" // 合同编号
},
"sign": "7627E9034C1D2CAE2CC21EC33619F01E"
}
SDK调用示例(Java):
JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchSignInfoRequest request = new ApplymentMchSignInfoRequest();
ApplymentMchSignInfoReqModel model = new ApplymentMchSignInfoReqModel();
model.setAgentNo("A1748575585"); // 代理商号
model.setMchNo(Jeepay.mchNo); // 商户号
model.setAppId(jeepayClient.getAppId()); // 应用ID
model.setApplyId("A1955515775041179649"); // 申请单ID
request.setBizModel(model);
try {
ApplymentMchSignInfoResponse 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());
}