内容方
渠道方
公共
接口描述
内容方通过此接口通知权益平台，针对具体用户发放场景活动的奖励信息
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/upbms/funParaReceiveBenefit
测试调用地址
https://openapi.unionpay.com/upapi/upbmstest/funParaReceiveBenefit
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。 | |||
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis();获取 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 银联场景流水号 | orderId | string | 33 | M-必填 | 权益平台场景专用流水号
|
||
| 用户ID | openId | string | N1..256 | M-必填 | 用户唯一标识
|
||
| 活动代码 | activityId | string | N1..256 | M-必填 | 用于标识具体场景活动，需线下具体约定
|
||
| 场景代码 | scenarioCode | string | N1..256 | M-必填 | 用于区分场景供应商的不同场景活动
|
||
| 通知类型 | type | string | N2 | M-必填 | 00 达标标志，01 积分值，02 权益编号
|
||
| 通知子类型 | subtype | string | N2 | C-按条件必填 | 暂时用于通知权益的分类
|
||
| 通知内容 | prize | string | N1..256 | M-必填 | 如果type为“00”时，返回00：达标；01：未达标；如果type为“01”，表示具体分值
|
||
| 内容附加信息 | addInfo | string | C-按条件必填 | 如果prize为QQ音乐，则参数值为QQ号；如果prize为链接券，则参数值为链接地址。以上都不是则为空值
|
|||
| 权益名称 | rightName | string | M-必填 |
|
|||
| 保留域 | retainInfo | string | C-按条件必填 |
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 6 | 000000 | M-必填 |
|
|
| 应答信息 | respMsg | string | C-按条件必填 | 如果respCd不是000000，该字段解释了具体的出错原因
|
|||
| 应答数据 | data | map | C-按条件必填 | 应答信息包括orderId银联流水号，以及当prize为随机红包时，返回红包金额packetAmount
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
