5.7.3银联云闪付单品优惠填写规范


注意:
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"}]}


yinjr 2024年7月15日 16:14 收藏文档