证件到期通知
文档描述:代理商/商户可通过订阅的通知地址得到商户证件到期信息
接口说明
适用对象:代理商 特约商户
请求方式:POST
请求URL:该链接为平台代配置的固定订阅通知地址
请求类型:application/json 或 application/x-www-form-urlencoded
“必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
通知参数
| 参数名 | 中文名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|---|
| notifyId | 通知ID | Y | String | N2003753893144268802 | 通知记录ID |
| notifyBizType | 通知类型 | Y | String | ST_LICENSE_EXT | ST_LICENSE_EXT-证件到期 |
| agentNo 代理商号 | C | String | A3929388111 | 代理商号 | |
| mchNo | 商户号 | Y | String | M3929388111 | 商户号 |
| appId | 应用APPID | Y | String | 686b6f5b46c83837aebd1db2 | 商户应用ID |
| ifCode | 渠道代码 | Y | String | shengpay | 通知的系统实际配置渠道 |
| state | 状态 | Y | String | 0 | 0-待更新, 1-待审核, 2-更新成功,3-更新失败, 4-已过期, 5-已关闭 |
| channelNotifyData | 渠道通知数据 | Y | Json | {} | 通道响应参;不同的通道下该参数值可能不同,注意处理 |
| reqTime | 请求时间 | Y | String | 1622016572190 | 请求接口时间,13位时间戳 |
| sign | 签名 | Y | String | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
channelNotifyData 数据参数(cpp)
shengpay
{
"channelUpdateUrl": "https://agentmerchant.shengpay.com/agent-merchant/licence/update?ticket=LC-1208921318badf45b",
// 更新证件地址
"channelMchNo": "00323249", // 盛付通子商户号
"channelLicenseType": "CORPORATE_ID_CARD" // 证件类型
}
通知示例:
{
"ifCode" : "shengpay",
"agentNo" : "A1648868625",
"appId" : "68f998f160b208e648f3ae47",
"sign" : "1EADA435B4422617678F097A130D237C",
"channelNotifyData" : "{\"channelUpdateUrl\":\"https://agentmerchant.shengpay.com/agent-merchant/licence/update?ticket=LC-1208921318badf45b\",\"channelMchNo\":\"00323249\",\"channelLicenseType\":\"CORPORATE_ID_CARD\"}",
"notifyId" : "N2004487797530611714",
"reqTime" : "1766742107170",
"state" : "0",
"mchNo" : "M1666702051",
"msgBizType" : "ST_LICENSE_EXT"
}
响应示例:(undefined)
SUCCESS