微信、支付宝单品接入指引
文档描述
本文档用于描述微信或者支付宝单品营销模块
1. 涉及到支付类型
1.1 支付接口
对应支付接口中的service：
unified.trade.micropay；【统一】付款码支付
pay.weixin.native；【微信】扫码支付
pay.weixin.jspay；【微信】公众号&小程序支付
unified.trade.pay，pay.weixin.raw.app；【微信】APP支付
微信：适用于所有版本的商户
支付宝：只适用于支付宝直连v2接口版本的商户
1.2 统一查询接口
对应查询接口中的service：unified.trade.query
微信：适用于所有版本的商户
支付宝：只适用于支付宝直连v2接口版本的商户
2. 支付接口：unified.trade.micropay
2.1 请求参数：
- 增加参数：goods_detail
- 格式：Json格式
- 属性：
| 字段名 | 变量名 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| cost_price | 订单原价 | 否 | int | 订单总金额，与total_fee一致 | 508 |
| receipt_id | 商品小票ID | 否 | String(32) | 商家小票ID | wx456 |
| goods_detail | 单品列表 | 是 | String | 单品信息，使用Json数组格式提交 | 示例见下文 |
以上三个参数为同一层级
单品列表goods_detail字段详情如下：
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| goods_id | 商品的编号 | 是 | String(32) | apple-01 |
| pay_goods_id | 微信/支付宝定义的商品编号 | 否 | String(32) | 20010001 |
| goods_name | 商品名称 | 是 | String(256) | ipad |
| quantity | 商品数量 | 是 | int | 1 |
| price | 商品单价，单位为分 | 是 | int | 2000 |
| goods_category | 商品类目 | 否 | String(24) | 34543238 |
| body | 商品描述信息 | 否 | String(1000) | 特价手机 |
| show_url | 商品的展示地址 | 否 | String(400) | http://www.xrtpay.com/xxx.jpg |
| version | 版本号 | 否 | String(32) | 固定值1.0 |
样例：
包含必填为否字段（部分）的情况：{“goods_detail”:[{“goods_id”:”8054489”,”goods_name”:”yp8054489”,”price”:100,”quantity”:1}],”receipt_id”:”wx123”,”cost_price”:500}
只含必填为是字段的情况：
{“goods_detail”:[{“goods_id”:”8054489”,”goods_name”:”yp8054489”,”price”:100,”quantity”:1}]}
goods_detail含多个单品参数：
{“goods_detail”:[{“goods_name”:”yp8054489”,”quantity”:3,”price”:100,”goods_id”:”8054489”},{“goods_name”:”yp8054489”,”quantity”:1,”price”:100,”goods_id”:”8066227”}]}
2.2 返回参数：
支付宝
2.2.1 增加参数：discount_goods_detail
2.2.2 样例：
[{“goods_id”:”STANDARD1026181538”,”goods_name”:”雪碧”,”discount_amount”:”100.00”,”voucher_id”:”2015102600073002039000002D5O”}]
微信
2.2.1 增加参数：promotion_detail
2.2.2 样例：
{“promotion_detail”:[{“promotion_id”:”2250427405”,”name”:”拜耳商品立减活动”,”scope”:”SINGLE”,”type”:”DISCOUNT”,”amount”:200,”activity_id”:”3321803”,”wxpay_contribute”:0,”merchant_contribute”:200,
“other_contribute”:0,”goods_detail”:[{“goods_id”:”8054489”,”quantity”:3,”price”:100,”discount_amount”:150},{“goods_id”:”8066227”,”quantity”:1,”price”:100,”discount_amount”:50}]}]}
3. 查询接口：unified.trade.query
返回参数
支付宝
1 增加参数：discount_goods_detail
2 样例：
[{“goods_id”:”STANDARD1026181538”,”goods_name”:”雪碧”,”discount_amount”:”100.00”,”voucher_id”:”2015102600073002039000002D5O”}]
微信
1 增加参数：promotion_detail
2 样例：
{“promotion_detail”:[{“promotion_id”:”2250427405”,”name”:”拜耳商品立减活动”,”scope”:”SINGLE”,”type”:”DISCOUNT”,”amount”:200,”activity_id”:”3321803”,”wxpay_contribute”:0,”merchant_contribute”:200,
“other_contribute”:0,”goods_detail”:[{“goods_id”:”8054489”,”quantity”:3,”price”:100,”discount_amount”:150},{“goods_id”:”8066227”,”quantity”:1,”price”:100,”discount_amount”:50}]}]}
