接口描述
资格券主子映射关系查询。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/mkt/cpn/cpnQuerySubQualActivity/v1
测试调用地址
暂无
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| CMD | cmd | string | 15 | M-必填 | 固定值：qualSubActQuery
|
||
| 渠道方代码 | chnlId | string | 4 | M-必填 | 渠道方代码，区分业务权限，进行数据权限控制,4位数字
|
||
| 活动编号 | activityNo | string | 16 | M-必填 | 31开头的资格券主活动ID
|
||
| 流水号 | transSeq | string | 64 | M-必填 | 外部接入方定义的主键，保证唯一，即流水号。数字字母组合，严禁出现下划线等特殊字符
|
HTTP消息头参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 样例值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | M-必填 | 取值：1.0.0
|
|||
| 发送方索引类型 | appType | string | 2 | M-必填 | 取值：00或01或02，其中00代表银联索引 、01代表机构索引 、02代表商户索引
|
|||
| 发送方索引标识码 | APPId | string | 32 | M-必填 | appId由开放平台网关分配，取值开放平台网关API认证账号
|
|||
| 接口类型 | bizMethod | string | 64 | M-必填 | 取值：mkt.cpn.cpnQuerySubQualActivity.v1
|
|||
| 签名 | sign | string | 344 | M-必填 | 对报文摘要的签名
|
|||
| 签名方式 | signMethod | string | 20 | M-必填 | 取值：RSA2、SM2，根据实际签名算法填写
|
|||
| 发送方流水号 | reqId | string | 64 | M-必填 | 由发送方自动生成
|
|||
| 时间戳 | reqTs | string | 32 | M-必填 | 当前时间戳
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | code | string | 10 | M-必填 | 成功应答码为’0000000000’失败应答码格式：第1-2位表示应答码生成方；第3-10位表示错误原因；取值详见应答码信息。
|
||
| 应答码描述 | msg | string | 128 | M-必填 | 同一个应答码可对应多个不同的描述，对处理结果进行详细提示
|
||
| 详细应答码 | subCode | string | 10 | C-按条件必填 | 当应答码非成功时出现，并且描述了详细的业务处理失败的原因。
|
||
| 详细应答码描述 | subMsg | string | 128 | C-按条件必填 | 同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。包含多个错误信息，供进一步分析错误原因使用。
|
||
| 子活动信息列表 | subActivityInfos | array | 800 | C-按条件必填 | 子活动信息列表
|
示例代码
l 请求报文头参数
{
“version”:”1.0.0”,
“appType”:”01”,
“appId”:”up_5issuytt11s_adqov”,
“bizMethod”:”mkt.cpn.cpnQuerySubQualActivity.v1”,
“sign”:”2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,
“signMethod”:”RSA2”,
“reqId”:”hfsjau2jirnwqn128h3j1nbsa213”,
“reqTs”:”1629365633609”
}
l 请求报文参数
{
"cmd" : "qualSubActQuery",
"transSeq" : "fe095ad18a50d76d6941c1d3c6c02aaffacd44fa61df70645ab4749547b437d",
"chnlId" : "2106",
"activityNo" : "3103200465873376"
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
