本文档是针对移动支付业务中开展优惠活动时涉及到的一些字段的说明，主要是单品优惠活动，但不限于单品优惠。供内部相关开发和技术支持人员与商户平台服务方技术人员使用，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
供商户平台服务方技术或业务人员参考和查询
格式：Json格式
属性：
| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 订单原价 | cost_price | 否 | int | 608 | 订单总金额，与total_fee一致 |
商品小票ID | receipt_id | 否 | String(32) | wx123 | 商家小票 |
| 商品列表 | goods_detail | 是 | String(6000) | 示例见下文 | 单品信息，使用Json数组格式提交 |
以上三个参数为同一层
单品列表goods_detail字段详情如下：
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
| 商品的编号 | goods_id | 是 | String(32) | 商家的商品编码 |
| 微信侧商品编码 | pay_goods_id | 否 | String(32) | 微信支付定义的统一商品编号（没有可不传） |
| 商品名称 | goods_name | 是 | String(256) | 商品的实际名称 |
| 商品数量 | quantity | 是 | int | 用户购买的数量 |
| 商品单价 | price | 是 | int | 单位为分，如传值100即表示1元 |
| 商品类目 | goods_category | 否 | String(24) | 34543238 |
| 商品描述信息 | body | 否 | String(1000) | 特价手机 |
| 商品的展示地址 | show_url | 否 | String(400) | http://www.alipay.com/xxx.jpg |
| 版本号 | version | 否 | String(32) | 固定值1.0 |
请求参数goods_detail字段值举例如下：
{
"cost_price": 608800,
"receipt_id": "wx123",
"goods_detail": [ //注意goods_detail字段的格式为"goods_detail":[{}],较多商户写成"goods_detail":{}
{
"goods_id": "商品编码",
"pay_goods_id": "1001",
"goods_name": "",
"quantity": 1,
"price": 528800
},
{
"goods_id": "商品编码",
"pay_goods_id": "1002",
"goods_name": "iPhone6s 32G",
"quantity": 1,
"price": 608800
}
]
}
字段名和值一起作为请求支付时的XML举例如下：
包含必填为否字段（部分）的情况：
<goods_detail><![CDATA[{"goods_detail":[{"goods_id":"8054489","goods_name":"yp8054489","price":100,"quantity":1}],"receipt_id":"wx123","cost_price":500}]]></goods_detail>
只含必填为是字段的情况：
<goods_detail><![CDATA[{"goods_detail":[{"goods_id":"8054489","goods_name":"yp8054489","price":100,"quantity":1}]}]]></goods_detail>
goods_detail含多个单品参数：
<goods_detail><![CDATA[{"goods_detail":[{"goods_name":"yp8054489","quantity":3,"price":100,"goods_id":"8054489"},{"goods_name":"yp8054489","quantity":1,"price":100,"goods_id":"8066227"}]}]]></goods_detail>
请特别注意：请求参数字段名goods_detail的值里面同样有一个goods_detail，经常有商户会漏了值里面的goods_detail导致优惠不生效
透传微信返回内容
格式：Json格式
属性：
| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 营销详情 | promotion_detail | 是 | String(6000) | 示例见下 | 营销详情列表，使返回值为Json格式 |
promotion_detail字段列表说明
以下字段及值作为goods_detail的值返回
| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 商品编码 | goods_id | 是 | String(32) | 商品编码 | 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成 |
| 商品备注 | goods_remark | 否 | String(128) | 1001 | goods_remark为备注字段，按照配置原样返回，字段内容在微信后台配置券时进行设置。 |
| 商品优惠金额 | discount_amount | 是 | int | 100 | 单品的总优惠金额，单位为：分 |
| 商品数量 | quantity | 是 | int | 1 | 用户购买的数 |
| 商品价格 | price | 是 | int | 528800 | 单位为：分 |
返回参数promotion_detail字段值举例如下：
{
"promotion_detail":[
{
"promotion_id":"109519",
"name":"单品惠-6",
"scope":"SINGLE",
"type":"DISCOUNT",
"amount":5,
"activity_id":"931386",
"wxpay_contribute":0,
"merchant_contribute":0,
"other_contribute":5,
"goods_detail":[
{
"goods_id":"a_goods1",
"goods_remark":"商品备注",
"quantity":7,
"price":1,
"discount_amount":4
},
{
"goods_id":"a_goods2",
"goods_remark":"商品备注",
"quantity":1,
"price":2,
"discount_amount":1
}
]
}
]
}
字段名和值一起作为返回时的XML举例如下：
<promotion_detail><![CDATA[{"promotion_detail":[{"promotion_id":"109519","name":"单品惠-6","scope":"SINGLE","type":"DISCOUNT","amount":5,"activity_id":"931386","wxpay_contribute":0,"merchant_contribute":0,
"other_contribute":5,"goods_detail":[{"goods_id":"a_goods1","goods_remark":"商品备注","quantity":7,"price":1,"discount_amount":4},{"goods_id":"a_goods2","goods_remark":"商品备注","quantity":1,"price":2,"discount_amount":1}]}]}]]></promotion_detail>
字段值举例如下：
[{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]
透传银联返回内容
格式：Json格式
属性：
| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 营销详情 | couponInfo | 是 | String(6000) | 示例见下文 | 营销详情列表，使返回值为Json格式 |
以下字段及值作为couponInfo的值返回
| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 项目编号 | id | 是 | String(32) | 2112020042604995 | 票券编号、活动编号等 |
| 项目简称 | desc | 否 | String(128) | 测试活动1 | 优惠活动简称，可用于展示、打单等 |
| 项目类型 | type | 是 | String(32) | CP01 | DD01 ：随机立减 CP01 ：抵金券1：无需领取，交易时直接适配并承兑的优惠券 CP02 ：抵金券2：事前领取，交易时上送银联并承兑的优惠券 |
| 出资方 | spnsrId | 否 | String(32) | 30258417361CUYO | 银联作为出资方：为固定值 00010000； 付款方作为出资方：为 8 位付款方机构代码； 商户作为出资方：为15 位商户代码 |
| 抵消交易金额 | offstAmt | 否 | Int | 100 | 单位为分 |
字段值举例如下：
{"couponInfo":[{"id":"2112020042604995","desc":"测试活动2","type":"CP01","spnsrId":"30258417361CUYO","offstAmt":"500"}]}
字段名和值一起作为返回时的XML举例如下：
<unionpay_discount><![CDATA[{"couponInfo":[{"id":"2112020042604995","desc":"测试活动2","type":"CP01","spnsrId":"30258417361CUYO","offstAmt":"500"}]}]]></unionpay_discount>