2.16. 券的核销
接口介绍:
API endpoint: {api_domain}/api/lite-member/v1/members/coupon/redeem
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| brand_code | 1 | String | 32 | 品牌编号,系统对接前由“收钱吧”提供 |
| out_trade_no | 1 | String | 64 | 商户订单号,64 个字符以内、可包含字母、数字、下划线; |
| redeem_list | 1 | Array | 32 | 券列表 |
| subject | 1 | String | 256 | 订单标题 |
| user_channel | 1 | String | 36 | 会员渠道。1, wechat; 2, alipay; 3, 手机号 |
| user_id | 1 | String | 255 | 微信用户为 UnionID,支付宝为用户 ID,手机号用户为手机号 |
| client_member_id | 0-1 | String | 36 | 商户端的用户 id |
| total_amount | 1 | Price | 11 | 订单总金额,单位为分 |
| body | 1 | String | 128 | 支付订单描述 |
| goods_detail | 0-1 | GoodsDetail [] | - | 订单包含的商品列表信息,json 格式,其它说明详见商品明细说明 |
| operator_id | 0-1 | String | 28 | 商户操作员编号 |
| store_id | 0-1 | String | 32 | 商户门店编号 |
| terminal_id | 0-1 | String | 32 | 商户机具终端编号 |
| extend_params | 0-1 | ExtendPara ms | 不限 | 业务扩展参数 |
RedeemList
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| coupon_no | 1 | String | 32 | - |
goods_detail
| 参数 | 是否必填 | 类型 | 最大长度 | 描述 |
|---|---|---|---|---|
| goods_id | 1 | String | 32 | 商品的编号 |
| goods_name | 1 | String | 256 | 商品名称 |
| quantity | 1 | Number | 10 | 商品数量 |
| price | 1 | Price | 9 | 商品单价,单位为元 |
| goods_category | 0-1 | String | 24 | 商品类目 |
| categories_tree | 0-1 | String | 128 | 商品类目树 |
| body | 0-1 | String | 1000 | 商品描述信息 |
返回参数:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| out_trade_no | 1 | String | 64 | 商户订单号 |
| trade_status | 1 | String | 32 | 见 3.1 |
| trade_no | 1 | String | 64 | 核销订单号 |
| total_amount | 1 | String | 10 | 订单价格,精确到分 |
| pay_amount | 1 | String | 10 | 实际支付的返回价格,精确到分 |
| collect_amount | 1 | String | 10 | 实际收款的返回价格,精确到分 |
| gmt_payment | 1 | Date | 32 | 交易支付时间 |
| redeem_fund_bill_list | 1 | Object | 不限 | 交易支付使用的资金渠道 |
redeem_fund_bill_list
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| coupon_no | 1 | String | 32 | - |
| total_amount | 1 | String | 10 | 订单价格,精确到分 |
| pay_amount | 1 | String | 10 | 实际支付的返回价格,精确到分 |
| collect_amount | 1 | String | 10 | 实际收款的返回价格,精确到分 |