观影券详情(使用记录)
基本信息
| 项目 |
内容 |
| 路由 |
/pages/ticket-package-detail/ticket-package-detail?claimId={领取记录ID}&talentId={持卡人ID}&merchantId={商家ID} |
| 页面目标 |
在「使用记录」里点开已领取的观影券,出示二维码给影城店员扫码核销,并查看领取/核销时间。 |
| 进入方式 |
个人中心 → 使用记录 → 观影券记录(targetDetailType=TICKET_PACKAGE_DETAIL)。 |
| 负责人/更新时间 |
待指定 / 2026-10-09 |
功能点
| 编号 |
功能 |
说明 |
当前状态 |
| F-001 |
核销二维码 |
展示票包兑换码的二维码(GET /api/app/benefit-verification-codes/ticket-package-claims/{claimId}/image),店员扫码后走观影权益核销。 |
已接入 |
| F-002 |
适用门店 |
展示票包配置的适用商家(多个用「、」连接)。 |
已接入 |
| F-003 |
领取时间 |
领取记录创建时间。 |
已接入 |
| F-004 |
核销时间 |
已核销后才显示。 |
已接入 |
| F-005 |
复制兑换码 |
未核销时可复制兑换码;已核销时按钮置灰显示「已使用」。 |
已接入 |
状态差异
| 状态 |
表现 |
未核销(ACTIVE) |
显示二维码、适用门店、领取时间;底部蓝色「复制兑换码」按钮可用。 |
已核销(USED) |
二维码保留(核销时服务端会拒绝重复核销),额外显示核销时间;底部按钮置灰显示「已使用」。 |
接口与数据
| 数据项/动作 |
接口标识 |
参数 |
返回字段 |
状态 |
| 领取详情 |
GET /api/app/ticket-packages/claims/{claimId} |
claimId、talentId |
merchantNames、exchangeCode、exchangeCodeStatus、createdAt、usedAt |
已接入 |
| 核销二维码 |
GET /api/app/benefit-verification-codes/ticket-package-claims/{claimId}/image |
claimId |
PNG 二维码 |
已接入 |
与「电影券领券成功」的区别
/pages/coupon-received/coupon-received 是领券成功页(展示可领取额度、兑换码与二维码);
本页是使用记录里的观影券详情,按「观影券」原型展示二维码、适用门店与领取/核销时间。