2.7. 查询会员单张卡的消费记录
接口介绍:
API endpoint: {api_domain}/api/lite-member/v1/members/card/redeemRecords
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大 32 位 | 品牌编号,系统对接前由“收钱吧”提供 |
card_number | 1 | String | 字符串,最大 36 位 | 需要查询的卡号 |
user_id | 1 | String | 字符串,最大 255 位 | 微信用户为 UnionID,支付宝为用户 ID,手机号用户为手机号 |
client_member_id | 0-1 | String | 字符串,最大 36 位 | 商户端的用户 id |
返回参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
card_number | 1 | String | 字符串,最大 36 位 | 需要查询的卡号 |
user_id | 1 | String | 字符串,最大 255 位 | 微信用户为 UnionID,支付宝为用户 ID,手机号用户为手机号 |
client_member_id | 0-1 | String | 字符串,最大 36 位 | 商户端的用户 id |
brand_code | 1 | String | 数字,最大 32 位 | 品牌编号,返回调用方传入的值 |
records | 1 | Array | - | 消费记录的数组 |
records:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
date | 1 | String | 字符串,最大 20 位 | 订单日期 |
time | 1 | String | 字符串,最大 20 位 | 订单时间 |
merchant_name | 0-1 | String | 字符串,最大 80 位 | 商户名称 |
merchant_sn | 0-1 | String | 字符串,最大 36 位 | 商户编号 |
store_name | 0-1 | String | 字符串,最大 80 位 | 门店名称 |
store_sn | 0-1 | String | 字符串,最大 36 位 | 门店编号 |
card_number | 1 | String | 字符串,最大 36 位 | 消费卡号 |
card_name | 1 | String | 字符串,最大 80 位 | 消费的卡的卡名称 |
card_surface_name | 0-1 | String | 字符串,最大 80 位 | 卡名名称 |
card_surface_url | 0-1 | String | - | 卡名图片 url |
client_sn | 1 | String | 字符串,最大 36 位 | 商户订单号 |
trade_no | 1 | String | 字符串,最大 36 位 | 交易流水号,总核销流水 |
order_number | 1 | String | 字符串,最大 36 位 | 核销订单号 |
order_status | 1 | String | 字符串,最大 4 位 | 订单状态 1:核销成功 2:退款成功 3:核销失败 4:退款失败 5:订单状态未知 |
order_type | 1 | String | 字符串,最大 4 位 | 订单类型 1:收款 2:退款 |
order_amount | 1 | String | 字符串,最大 11 位 | 订单金额,以分为单位 |
redeem_amount | 0-1 | String | 字符串,最大 11 位 | 核销金额,以分为单位 |
redeem_net_amount | 0-1 | String | 字符串,最大 11 位 | 核销净额,以分为单位 |
discount_rate | 0-1 | String | 字符串,最大 11 位 | 折扣率 |
card_before_amount | 1 | String | 字符串,最大 11 位 | 核销之前卡的余额,以分为单位 |
card_after_amount | 1 | String | 字符串,最大 11 位 | 核销之后卡的余额,以分为单位 |
card_before_net_amount | 1 | String | 字符串,最大 11 位 | 核销之前卡的净额,以分为单位 |
card_after_net_amount | 1 | String | 字符串,最大 11 位 | 核销之后卡的净额,以分为单位 |