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 | 实际收款的返回价格,精确到分 |