跳转至

商户信息过期查询接口

请求方式 body 编码 接口地址
POST application/json UTF-8 集测:https://mchapitest.shengpay.com/mchfacade/v1/license/complement/query
生产:https://mchapi.shengpay.com/mchfacade/v1/license/complement/query

接口描述

查询指定商户资质过期或变更的数据 通过返回 complementLink 页面链接,提交待更新或修改的数据

请求参数

变量名 类型 必填 示例值 描述
mchId String(16) Y 30057909 服务商商户号
subMchId String(16) Y 商户号
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

请求示例

1
2
3
4
5
6
7
{
    "mchId": "",
    "subMchId": "",
    "nonceStr": "nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy",
    "signType": "RSA",
    "sign": "VJwA2kXDnLiC8bH7Ywzc/fktd5zITLi9d5dobzaf3PCKy7hMecg1zqQz9X9GhqLMj5e2dOeDI2mrF06EJZdugcD+5BW2MA+MK32eMuwoRAh510HSusN2HaE4ser99rLJSvMPn5bEqNdDX83XixGePa4iyFiV0YdOfDu0T6VgDBFwbO0St73j0NxgPrIVM/tTmax1jwsAUl60BG4N+LKZxQYH0whsUOE9jgAjhcX8BD0GC3BMzNaEZyrn6noWvA6Ir95f/ZXww07rp8vPPzn99LtNzBFczx3k3H9o4e4K5BL+d+bzULMm9VvWrSObBri+wMy+VB978wGVftobFUkn/Q=="
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
rows String N json数组字符串
eventType String(32) Y 过期事件类型
资质信息过期:CERTIFICATE_EXPIRED
资质信息过期:CERTIFICATE_CHANGE
licenseType String(32) Y 资质类型
法人证件-CORPORATE_ID_CARD
委托人证件-PRINCIPAL_ID_CARD
营业执照-BUSINESS_LICENSE
idDocType String(32) N 法人/委托人证件类型,
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(32) Y 创建时间
expireTime String(32) Y 过期时间
serialNo String(32) Y 流水号
ticket String(64) N
complementLink String N 信息补充页面
status String(32) Y 状态
状态 WAIT:待更新
AUDIT:待审核
FAIL:审核失败
SUCCESS:成功
EXPIRE:超过限定期限
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名

响应参数

1
2
3
4
5
6
7
8
{
    "returnCode": "SUCCESS",
    "resultCode": "SUCCESS",
    "rows": "[{\"complementLink\":\"http://anntest.shengpay.com/agent-merchant/licence/update?ticket=LC-757396207891243008\",\"eventType\":\"CERTIFICATE_EXPIRED\",\"expireTime\":\"2019-06-19 23:59:59\",\"licenseType\":\"BUSINESS_LICENSE\",\"status\":\"AUDIT\",\"ticket\":\"LC-757396207891243008\"}]",
    "sign": "XyIoxGodrNZqsPE6xut9Yd0Pq5sk1VBkKAb7McrBgRtJr7R83u3n5ckTZByn4rxXUglViO3EYA8sYCWl54nNQf+5AVluJIZu5BmO6rZLxtgcCE2ismw3nqTX880RK/E+HtFHnpBqyf14ua5+MQ1gvt0r+klql7/+Osu3QF9LtGk=",
    "signType": "RSA",
    "nonceStr": "iuwYIztuezXtzoJmRfsDZKhsFTxOuznj"
}
Back to top