2.14. 卡的核销退款
接口介绍:
API endpoint: {api_domain}/api/lite-member/v1/members/card/refund
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数:
参数 | 必填 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大 32 位 | 品牌编号,系统对接前由“收钱吧”提供 |
out_trade_no | 0-1 | String | 64 | 订单支付时传入的商户订单号,不能和 trade_no 同时为空。 |
trade_no | 0-1 | String | 64 | 核销订单号,和商户订单号不能同时为空 |
refund_list | 0-1 | Array | 32 | 卡列表 |
refund_reason | 0-1 | String | 256 | 退款的原因说明 |
body | 1 | String | 128 | 退款订单描述 |
out_request_no | 0-1 | String | 64 | 标识一次退款请求,同一笔交易多次退款需要保证唯一,如需部分退款,则此参数必传。 |
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 |
store_id | 0-1 | String | 32 | 商户门店编号,对应收钱吧门店门店编号 |
terminal_id | 0-1 | String | 32 | 商户机具终端编号,对应收钱吧终端号 |
operator_id | 0-1 | String | 30 | 商户的操作员编号 |
goods_detail | 0-1 | GoodsDetail[] | 不限 | 订单包含的商品列表信息,json 格式,其它说明详见商品明细说明 |
RefundList
参数 | 必填 | 类型 | 约束 | 描述 |
---|---|---|---|---|
card_number | 1 | String | 32 | - |
total_amount | 0-1 | String | 10 | 订单价格,精确到分 |
返回参数:
参数 | 必填 | 类型 | 约束 | 描述 |
---|---|---|---|---|
trade_no | 1 | String | 64 | 核销订单号 |
out_trade_no | 1 | String | 64 | 商户订单号 |
refund_fee | 1 | Price | 11 | 退款总金额 |
gmt_refund_pay | 1 | Date | 32 | 退款支付时间 |
pay_amount | 0-1 | String | 11 | 支付金额 |
total_amount | 1 | Price | 11 | 交易金额 |
collect_amount | 1 | String | 11 | 实收金额 |
refund_fund_bill_list | 1 | Object | 不限 | 交易退款使用的资金渠道 |
refund_fund_bill_list
参数 | 必填 | 类型 | 约束 | 描述 |
---|---|---|---|---|
card_number | 1 | String | 32 | - |
total_amount | 1 | String | 10 | 订单价格,精确到分 |
pay_amount | 1 | String | 10 | 实际支付的返回价格,精确到分 |
collect_amount | 1 | String | 10 | 实际收款的返回价格,精确到分 |