查询卡券

根据卡券码查询卡券信息，支持优惠券和卡（礼品卡/次卡）。

请求接口

POST /open/cashier/coupon/query

通用参数

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

请求参数

参数	必填	类型	说明
code	是	String	卡券码

响应参数

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

请求示例

{
  "code": "CPN20260507000001"
}

响应示例

优惠券

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": "CPN20260507000001",
    "name": "满100减20优惠券",
    "type": "coupon",
    "sub_type": "cash",
    "description": "满100减20",
    "display_value": "20元",
    "face_value": "20"
  }
}

礼品卡

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": "CARD20260507000001",
    "name": "100元礼品卡",
    "type": "card",
    "sub_type": "gift",
    "balance": 5000
  }
}

次卡

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": "CARD20260507000002",
    "name": "10次洗车卡",
    "type": "card",
    "sub_type": "times",
    "remain_count": 6
  }
}