客户端小程序 — 外部券码核销

上级文档：客户端小程序

---

概述

对应主文档 §2.1（外部券码）

外部券码核销用于处理用户在抖音、美团等外部平台购买的兑换券，支持两种核销方式：

1. 手动输入券码：用户复制券码后粘贴
2. 线下扫码：用户扫描门店张贴的二维码跳转到兑换页

页面路由

路由	页面	说明
/pages/voucher/redeem	兑换券码	手动输入 / 扫码

手动输入 + 扫码

兑换页要素

• 返回按钮 + 「兑换券码」标题
• 说明文案：「在抖音/美团等平台购买的券码，在此兑换使用」
• 输入框：支持粘贴券码
• 「或」分隔线
• 扫码入口：调用 wx.scanCode，二维码内容为券码字符串
• 「立即兑换」按钮

交互规则

1. 输入框支持粘贴
2. 扫码调用 wx.scanCode，二维码内容为券码字符串
3. 兑换成功展示获得的产品和有效期
4. 失败展示具体原因：券码无效 / 已使用 / 已过期 / 活动已结束
5. 同一批次同一用户限兑换 1 张

异常处理

异常	处理
券码无效	「该券码不存在或已失效」
已使用	「该券码已被使用」
已过期	「该券码已过期」
活动已结束	「该活动已结束，无法兑换」
重复兑换	「同一批次限兑换 1 张」
扫码失败	提示「扫描失败，请重试」

接口

POST /api/v1/vouchers/redeem
  Auth: JWT
  Body: { code: string }
  Response: {
    success: boolean,
    message: string,
    order?: Order
  }