热门营销活动列表

运营 开发者 快速接入
热门营销活动列表产品是面向持卡人推广的营销、优惠、客户服务等热门活动信息。产品汇集了最新的银联卡支付折扣活动、银联客服活动、云闪付优惠活动,让用户能够第一时间了解并参与活动。

接入服务商:银联开放平台

API ID:471

接口状态:正常

业务申请
暂不支持测试

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: https://openapi.unionpay.com/upapi/cmpHotActivitytest/token


生产地址: https://openapi.unionpay.com/upapi/cmpHotActivity/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in string M-必填 凭证有效时间,单位:秒

接口名称

热门活动信息查询

接口描述

获取0-5个热门活动的相关信息。

接口地址

测试地址: https://openapi.unionpay.com/upapi/cmpHotActivitytest/cmpActivity


生产地址: https://openapi.unionpay.com/upapi/cmpHotActivity/cmpActivity

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位毫秒,对于Java一般使用System.currentTimeMillis();获取

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
渠道代码 channelNo string M-必填 01~99

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
活动id seqId long M-必填
活动状态 recSt string 2 M-必填
活动标题 activityTitle string M-必填 变长[0-100]
活动序号 activitySeq string M-必填 变长[0-9]
活动链接 activityLink string M-必填 变长[0-300]
产品详情

热门营销活动列表产品通过移动互联网渠道,向持卡人用户提供银联热门活动信息。与APP接口对接以及移动交互,将热门营销活动列表产品至各类APP内,应对不同合作伙伴的对接诉求。

2.png

应用场景

可用于精准营销等场景,提升用户触,整合营销效能,大幅度提升用户粘性。

应用对象

限定商户、机构用户

接入流程

1、目前该产品API仅面向特定的商户、机构提供服务,如有相关需求,请发送邮件至业务接口人说明相关使用需求;

2、商户、机构用户请提供相关银联入网证明材料;开发者用户请提供身份证相关信息;

3、技术联调,可参照《“快速接入”产品API技术文档-接入指南》


应答码参照:
应答码 描述
0000 处理成功。
9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(https://open.unionpay.com/tjweb/user/info)进行白名单登记。
9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。
9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。
9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置。
9905 请求参数值有误,请确认请求参数信息。
9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。
9907 app_id与app_secret验证失败。
9908 您的Token已过期,请重新获取Token。
9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。
9910 您的签名密钥未设置,请登录银联开放平台(https://open.unionpay.com/tjweb/user/info)确认相关配置。
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。
9912 您的报文格式有误,要求报文符合JSON数据格式。
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求。
9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
9915 您的API调用额度已耗尽,需充值付费后补充调用额度。
9916 您的API并发调用额度已耗尽,需联系管理员调整您的并发限额。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
9991 银联开放平台系统内部错误:产品服务调用失败。
9992 银联开放平台系统内部错误:产品服务系统未知错误。
9993 银联开放平台系统内部错误:产品服务未注册至服务中心。

1.报文举例-获取产品调用token信息:


请求URL:

 

https://openapi.unionpay.com/upapi/cmpHotActivity/token?app_id=[value]&app_secret=[value]


 

应答JSON报文体

{
    "token": "fsddfssseessseee",
    "expire_in": 7200
}



2.报文举例-热门活动信息查询


请求URL:


https://openapi.unionpay.com/upapi/cmpHotActivity/cmpActivity?token=[token]&sign=[sign]&ts=[ts]


请求报文参数:


{

    “channelNo”:”02”
}


应答JSON报文体:


{
    "respCd": "0000",
    "respMsg": "",
    “data”: [
     {
        "activitySeq":"",
        "recSt":"",
        "activityTitle":"",
        "seqId":10,
        "activityLink":""
     },
            {...},...
         ]   
}


1. “快速接入”产品API使用教程请参考在线文档:

《“快速接入”产品API指南—接入指南》


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1《“快速接入”产品API指南—获取产品token》

2.2《“快速接入”产品API指南—产品功能接口调用》


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

《“快速接入”产品API指南—报文签名样例代码》


4. “快速接入”产品API测试工具使用说明请参考在线文档:

《“快速接入”产品API指南—“快速接入”测试工具》


咨询我们
业务咨询
姓名: 马振东
电话: 021-20633298
邮箱: mazhengdong@unionpay.com
技术咨询
姓名: 李祉浩
电话: 021-20637084
邮箱: lizhihao@unionpay.com
热门推荐