查询会员卡模板

查询指定商户可用的会员卡模板列表。

请求

GET /open-api/v1/card-templates

请求参数

参数	类型	必填	说明
merchantId	long	否	商户 ID，不传则返回所有授权商户的模板
pageNo	int	否	页码，默认 1
pageSize	int	否	每页条数，默认 10

请求示例

curl -X GET 'https://openapi.example.com/open-api/v1/card-templates?merchantId=1001&pageNo=1&pageSize=10' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

响应

响应参数

字段	类型	说明
list	array	模板列表
list[].id	long	模板 ID
list[].templateName	string	模板名称
list[].cardType	int	卡类型：0-储值卡 1-次卡 2-时段卡
list[].price	int	售价（分）
list[].originalPrice	int	原价（分）
list[].validDays	int	有效天数
list[].description	string	模板说明
list[].benefits	array	权益列表
total	long	总记录数

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 3001,
        "templateName": "年度VIP会员卡",
        "cardType": 0,
        "price": 99900,
        "originalPrice": 199900,
        "validDays": 365,
        "description": "年度VIP专属优惠",
        "benefits": [
          "全场商品9折",
          "每月1次免费护理",
          "生日双倍积分"
        ]
      }
    ],
    "total": 1,
    "pageNo": 1,
    "pageSize": 10
  }
}