注意:
1.仅支持被扫交易,即4.2统一扫码接口
2.统一扫码交易同步返回在渠道信息(chnldata )返回银联优惠信息(couponInfo).
3.银联云闪付单品优惠交易退货不支持部分退款,并且需要在退款接口上送原交易的优惠信息,见4.4退款接口
benefitdetail是包含了以下字段的json字符串
参数 | 参数名称 | 数据类型 | 可空 | 备注 |
---|---|---|---|---|
orderInfo | 订单明细内容 | UnOrderInfo | 否 | 如订单标题、订单描述等 |
goodsInfo | 商品明细内容 | List | 否 |
其中UnOrderInfo包含字段如下:
参数 | 参数名称 | 数据类型 | 可空 | 备注 |
---|---|---|---|---|
title | 商品编码 | String(100) | 否 | |
description | 订单描述 | String(200) | 否 | |
dctAmount | 可优惠金额 | int | 是 | 当前订单可以参与优惠计算的金额 |
addnInfo | 附加信息 | String(100) | 是 | 用户自定义 |
其中UnGoodDetail包含字段如下:
参数 | 参数名称 | 数据类型 | 可空 | 备注 |
---|---|---|---|---|
id | 商品编码 | String(32) | 否 | |
name | 商品名称 | String(256) | 否 |
商品的实际名称 上送报文不要使用特殊符号/ 和 * ,否则会被安全设备视为敏感恶意注入行为并拦截请求 |
quantity | 商品数量 | int | 否 | 用户购买的数量 |
price | 商品单价 | int | 否 | 单位为:分 |
category | 商品类目 | String(24) | 是 | |
addnInfo | 附加信息 | String(100) | 是 |
用户自定义 上送报文不要使用特殊符号/ 和 * ,否则会被安全设备视为敏感恶意注入行为并拦截请求 |
填写样例:
benefitdetail={"goodsInfo":[{"id":"testsp000005","price":"600","name":"商品 1","quantity":"2"},{"id":"testsp000006","price":"500","name":"商品 2","quantity":"1"}],"orderInfo":{"title":"日用品","dctAmount":"1900","addnInfo":"日屈臣氏(人民广场)店"}}
交易成功返回优惠信息字段:
参数 | 参数名称 | 数据类型 | 可空 | 备注 |
---|---|---|---|---|
id | 项目编号 | String(40) | 否 | 票券编号、活动编号等,格式自定义 |
type | 项目类型 | String(4) | 否 | |
offstAmt | 抵消交易金额 | int | 否 | 单位为:分 |
spnsrId | 出资方 | String(20) | 否 | |
desc | 项目简称 | String(60) | 否 | 优惠活动简称,可用于展示、打单等 |
addnInfo | 附加信息 | String(100) | 是 | 用户自定义 |
响应样例:
chnldata ={"couponInfo":[{"id":"2112019092900801","desc":"银联单品测试联调-折后一口价","addnInfo":"小票打印信息测试","type":"CP01","spnsrId":"00010000","offstAmt":"800"}]}