搜索结果

×

搜索结果将在这里显示。

签约查询

接口描述:代理商可通过该接口查询商户进件申请单签约信息

渠道代码 渠道名称 是否适用当前接口 申请单状态 说明
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());
}