进件接口 - 证件临期信息查询

证件临期信息查询

接口描述：可通过该接口查询商户证件临期信息（如营业执照、法人证件等即将过期或已变更的资质信息）

接口说明

适用对象：代理商

请求URL：https://pay.yintongzaixian.com/api/mchApplyment/licenseExpInfo/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

"必填"字段取值"Y"：必填；"N"：非必填；"C"代表条件必填；

请求参数

参数名	中文名	必填	类型	示例值	说明
ifCode	支付接口代码	Y	String	shengpay	支付接口代码，如：shengpay
agentNo	代理商号	C	String	A3929388111	代理商发起时必填
mchNo	商户号	Y	String	A3929388111 (代理商) M3929388111（商户号）	代理商发起固定传入代理商号；若为商户主动发起则传入商户号；
appId	应用APPID	Y	String	686b6f5b46c83837aebd1db2	商户应用ID
reqTime	请求时间	Y	String	1622016572190	请求接口时间,13位时间戳
version	接口版本	Y	String	1.0	接口版本号，固定：1.0
sign	签名	Y	String	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
signType	签名类型	Y	String	MD5	签名类型，目前只支持MD5或RSA2方式

响应参数说明：

参数名	中文名	类型	说明
eventType	过期事件类型	String	资质信息过期：CERTIFICATE_EXPIRED 资质信息变更：CERTIFICATE_CHANGE
licenseType	资质类型	String	法人证件：CORPORATE_ID_CARD 委托人证件：PRINCIPAL_ID_CARD 营业执照：BUSINESS_LICENSE
idDocType	法人/委托人证件类型	String	中国大陆居民-身份证：RESIDENT_ID_CARD 其他国家或地区居民-护照：IDENTIFICATION_TYPE_OVERSEA_PASSPORT 中国香港居民-来往内地通行证：IDENTIFICATION_TYPE_HONGKONG_PASSPORT；中国澳门居民-来往内地通行证：IDENTIFICATION_TYPE_MACAO_PASSPORT 中国台湾居民-来往大陆通行证：IDENTIFICATION_TYPE_TAIWAN_PASSPORT 港澳居民证：IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT 台湾居民证：IDENTIFICATION_TYPE_TAIWAN_RESIDENT 外国人居留证：IDENTIFICATION_TYPE_FOREIGN_RESIDENT
createTime	创建时间	String	创建时间：2025-02-06 10:12:04
expireTime	过期时间	String	过期时间：2025-02-25 23:59:59
serialNo	流水号	String	流水号
complementLink	信息补充页面	String	用于补充更新资质信息的页面链接
status	状态	String	待更新：WAIT 待审核：AUDIT 审核失败：FAIL 成功：SUCCESS 超过限定期限：EXPIRE
ticket	工单号	String	工单号

响应说明：

data 中 licenseExpInfoList 为数组类型，包含一条或多条证件临期信息记录；
若商户无临期证件信息，则返回空数组。
请求示例：

{
    "agentNo": "A3929388111",
    "mchNo": "M3929388111",
    "appId": "686b6f5b46c83837aebd1db2",
    "ifCode": "shengpay",
    "sign": "A1144E7281971619FA89DA2153F54CB8",
    "signType": "MD5",
    "reqTime": "1754445551041",
    "version": "1.0"
}

响应结果：

{
    "code": 0,
    "data": {
        "licenseExpInfoList": [
            {
                "complementLink": "https://agentmerchant.shengpay.com/agent-merchant/licence/update?ticket=LC-109420299920944332",
                "createTime": "2025-02-06 10:12:04",
                "eventType": "CERTIFICATE_CHANGE",
                "expireTime": "2025-02-25 23:59:59",
                "idDocType": "RESIDENT_ID_CARD",
                "licenseType": "BUSINESS_LICENSE",
                "serialNo": "750002",
                "status": "AUDIT",
                "ticket": "LC-109420299920944332"
            }
        ]
    },
    "msg": "SUCCESS",
    "sign": "AB5F914EE24D456AC399D14CD9092874"
}

SDK调用示例（Java）：

JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchLicenseExpInfoQueryRequest request = new ApplymentMchLicenseExpInfoQueryRequest();
ApplymentMchLicenseExpInfoQueryReqModel model = new ApplymentMchLicenseExpInfoQueryReqModel();
model.setAgentNo("你的代理商号");
model.setMchNo("你的商户号（M开头）");                  // 商户号
model.setAppId("你的商户应用APPID");                   // 应用ID
model.setIfCode("shengpay");                        // 支付接口代码

request.setBizModel(model);
try {
    ApplymentMchLicenseExpInfoQueryResponse 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());
}

搜索结果