4.4 支付渠道优惠信息填写规范（benefitdetail字段）

微信单品优惠填写规范

需填写goods_tag和benefitdetail字段，其中benefitdetail是包含了以下字段的json字符串：

参数	参数名称	数据类型	可空	备注
cost_price	订单原价	int	是	单位:分跟trxamt一致 1.商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。 2.当订单原价与支付金额不相等，则不享受优惠。 3.该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。
receipt_id	商品小票ID	String(32)	是
goods_detail	单品列表	List<GoodDetail>	否

GoodDetail的字段如下:

参数	参数名称	数据类型	可空	备注
goods_id	商品编码	String(32)	否	由半角的大小写字母、数字、中划线、下划线中的一种或几种组成
wxpay_goods_id	微信侧商品编码	String(32)	是	微信支付定义的统一商品编号（没有可不传）
goods_name	商品名称	String(256)	是	商品的实际名称上送报文不要使用特殊符号/ 和 * ，否则会被安全设备视为敏感恶意注入行为并拦截请求
quantity	商品数量	int	否	用户购买的数量
price	商品单价	int	否	单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)

单品优惠数据样例:

benefitdetail={"goods_detail":[{"price":10,"goods_id":"cola50","goods_name":"cola","quantity":10}],"cost_price":120}&goods_tag=laoguo

支付宝智慧门店填写规范

支付宝智慧门店需要进行报备，具体咨询业务经理。（只支持主扫和被扫）

需填写chnlstoreid和benefitdetail字段；chnlstoreid为该商户在支付宝的商户门店号；benefitdetail是优惠商品详情的列表。

其中商品详情字段如下：

参数	参数名称	数据类型	可空	示例
goods_id	商品的编码	String(32)	否	apple-01
goods_name	商品名称	String(256)	否	ipad 上送报文不要使用特殊符号/ 和 * ，否则会被安全设备视为敏感恶意注入行为并拦截请求
quantity	商品数量	Number(10)	否	1
price	商品单价，单位为元	Price(9)	否	2000
goods_category	商品类目	String(24)	可	34533238
categories_tree	商品类目树，从商品类目根节点到叶子节点类目id组成，类目id值使用\|分割	String(128)	可	123123123\|1212313\|12313123
body	商品描述信息	String(1000)	可	特价手机上送报文不要使用特殊符号/ 和 * ，否则会被安全设备视为敏感恶意注入行为并拦截请求
show_url	商品的展示地址	String(400)	可	http://www.alipay.com/xxxx.jpg

样例数据:
benefitdetail=[{"price":2,"goods_id":"900820400100","goods_name":"900820400iphonex ","quantity":1}]&chnlstoreid=240610147@020012003

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

注意：
1.仅支持被扫交易，即4.2统一扫码接口
2.统一扫码交易同步返回在渠道信息（chnldata ）返回银联优惠信息(couponInfo).
3.银联云闪付单品优惠交易退货不支持部分退款，并且需要在退款接口上送原交易的优惠信息，见4.4退款接口
benefitdetail是包含了以下字段的json字符串：

参数	参数名称	数据类型	可空	备注
orderInfo	订单明细内容	UnOrderInfo	否	如订单标题、订单描述等
goodsInfo	商品明细内容	List<UnGoodDetail>	否

其中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"}]}