中国银联开放平台

支持中心

接口列表

中国银联消息中心推送服务-云网消息

查看产品

更新时间：2024-01-12

中国银联消息中心推送服务-云网消息

接口描述

支持合作方发送云网消息内容

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/mtsyw/sendYw

测试调用地址

暂无

HTTP报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
版本号	version	string	8	1	M-必填	必填
用户类型	userType	string	2		M-必填	用户类型 09：云网用户openId 10：授权用户ID（hid）
渠道类型	channelType	string	2		M-必填	渠道类型，09：云网渠道
业务类型	msgBizType	string	2		M-必填	取值范围00：交易类、01：系统通知类、02：营销推广类，目前无技术含义，仅做业务区分。
消息个性化数据	msgData	string	65536		M-必填	采用json格式存放个性化字段。具体存放的要求见后面的“个性化字段说明”

HTTP消息头参数

中文名称	英文名称	域类型	域长度	请求要求	备注
版本号	version	string	8	M-必填	格式：xx.yy.zz 取值举例：1.0.0
发送方索引类型	appType	string	2	M-必填	取值： 00：银联索引 01 机构索引 02 商户索引
发送方索引标识码	appId	string	32	M-必填	开放平台API认证账号，于开放平台个人中心创建
接口类型	bizMethod	string	64	M-必填	产品标识与接口标识组成取值举例：mtsyw.sendYw
签名	sign	string	344	M-必填	对报文摘要的签名
签名或摘要方式	signMethod	string	20	M-必填	取值： RSA2：先使用SHA-256计算摘要，再使用RSA完成签名，样例代码参考3.2 SM2：先使用SM3计算摘要，再使用SM2完成签名，样例代码参考3.3
发送方流水号	reqId	string	64	M-必填	由发送方自动生成
时间戳	reqTs	string	32	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis();获取

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
一级应答码	code	string	10	M-必填	参考左侧菜单“应答码参照”，成功返回 0000000000
应答消息	msg	string		M-必填	如果code不是0000000000，该字段解释了大概的出错原因。
二级应答码	subCode	string	10	C-按条件必填	由服务方设置，长度为10,当code不是0000000000时才展示
应答消息	subMsg	string		C-按条件必填	如果code不是0000000000，该字段解释了具体的出错原因，当code不是0000000000时才展示

示例代码

Java请求代码
Java应答代码

l请求方法

POST

l请求URL

https://openapi.unionpay.com/upapi/mtsyw/sendYw

l请求报文头参数

{

“version”:”1.0.0”,

“appType”:”02”,

“appId”:”up_5issuytt11s_adqov”,

“bizMethod”:”mtsyw.sendYw”,

“sign”:”2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,

“signMethod”:”RSA2”,

“reqId”:”hfsjau2jirnwqn128h3j1nbsa213”,

“reqTs”:”1629365633609”

}

l请求报文参数

{

"version":"1.0",

"msgBizType":"01",

"channelType":"09",

"userType":"09",

"msgData":{

"appId":"cdcad22d12b54bfa8b41e545dc6a32e6",

"indusAppId":"indusAppId123",

"issInsCdId":"49991001",

"sourceUserId":"isiR9po4N6KqHvpOESVuACgbUg3BvQg4p0c8CXH9Drwc3nCB51upqib5FBxHTu%2Bq",

"msgTitle":"标题",

"msgDetailsURLType":"H5",

"msgTxt":"内容",

"msgDetailsURL":"www.cloudnet.com",

"indusAppName":"indusAppName",

"msgPostId":"msgPostId"

}

复制

提示信息

提示