核销记录

查询卡券核销记录列表。

请求接口

POST /open/cashier/coupon/record

通用参数

• 请求签名：Authorization Header，详见签名方法
• 客户端信息：Ikudot-Cashier-Client Header，详见客户端信息；

请求参数

参数	必填	类型	说明
begin_time	否	String	开始时间，格式 yyyy-MM-dd HH:mm:ss，默认近3天
end_time	否	String	结束时间，格式 yyyy-MM-dd HH:mm:ss，默认当前时间
page_num	否	Integer	页码，默认 1
page_size	否	Integer	每页条数，默认 20，最大 100

响应参数

返回核销记录数组，每项结构如下：

参数	类型	说明
use_no	String	核销单号
code	String	卡券码
name	String	卡券名称
type	String	类型：coupon-优惠券，card-卡，参见卡券类型
sub_type	String	子类型编码，参见卡券类型
display_name	String	展示名称
description	String	说明
display_value	String	通用展示值
face_value	String	面额（优惠券）
balance	Long	余额（礼品卡），单位：分
remain_count	Integer	剩余次数（次卡）
status	String	核销状态编码
status_name	String	核销状态名称
result_msg	String	结果说明

请求示例

{
  "begin_time": "2026-05-01 00:00:00",
  "end_time": "2026-05-07 23:59:59",
  "page_num": 1,
  "page_size": 20
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "use_no": "USE20260507000001",
      "code": "CPN20260507000001",
      "name": "满100减20优惠券",
      "type": "coupon",
      "sub_type": "cash",
      "display_name": "满100减20优惠券",
      "description": "满100减20",
      "display_value": "20元",
      "face_value": "20",
      "status": "SUCCESS",
      "status_name": "核销成功",
      "result_msg": "核销成功"
    },
    {
      "use_no": "USE20260507000002",
      "code": "CARD20260507000001",
      "name": "100元礼品卡",
      "type": "card",
      "sub_type": "gift",
      "display_name": "100元礼品卡",
      "display_value": "100元",
      "balance": 5000,
      "status": "SUCCESS",
      "status_name": "核销成功",
      "result_msg": "核销成功"
    }
  ]
}