权益卡封装模式

权益卡模式允许合作方将晓葆健康站检测次数打包为实体卡或数字卡分发给用户。 用户激活权益卡后，可使用卡内次数预约健康站。

权益卡模式介绍

权益卡（Benefit Card）是将一组健康权益打包销售或赠送的载体。 每张卡包含若干权益项（Benefit Item），每个权益项对应一种服务（如「健康站全套检测×3次」）。

典型使用流程

1. 合作方（或晓葆运营）批量生成权益卡并分发（实体卡或短信/推送）
2. 用户在 App 内输入卡号 + 激活码，调用激活接口
3. 激活成功后，权益项自动关联到用户账号
4. 用户预约健康站时，可选择使用权益卡次数核销
5. 检测完成，次数扣减，合作方通过 Webhook 或查询接口获取核销记录

检测待激活卡

检测当前账号是否有平台预绑定（待激活）的权益卡。 返回待激活卡列表，可引导用户一键快速激活。

校验卡号激活码

在激活前校验卡号和激活码是否有效（不消耗激活次数），用于前端实时反馈。

请求体：

激活权益卡

激活权益卡并绑定到当前用户账号，每张卡只能激活一次。

请求体：

成功响应（201 Created）：

{
  "success": true,
  "code": 0,
  "message": "权益卡激活成功",
  "data": {
    "benefit_card_id": 8001,
    "card_name": "健康检测年卡",
    "expires_at": "2027-04-01",
    "items": [
      {
        "item_id": 201,
        "item_name": "健康站全套检测",
        "total_count": 12,
        "used_count": 0,
        "remaining_count": 12
      }
    ]
  }
}

权益卡列表

返回当前用户所有权益卡（包括已过期），支持 status 过滤。

权益卡详情

返回指定权益卡的完整信息，包含所有权益项的剩余次数。

使用记录

返回指定权益卡的使用历史，每条记录包含核销时间、核销健康站、检测结果概要。