**与后台的关联说明：**
> - 移动端根据后台"是否权益平台兑换"、"商品类型"和"是否有详情页"组合判断跳转逻辑
>
> - 后台"是否权益平台兑换"分为两类：**是**（商品类型为券码或微信立减金）、**否**（第三方权益：太古地产/龙腾/h5链接/小程序链接）
>
> - 后台"外部权益链接"字段（太古地产/龙腾/h5链接/小程序链接）决定外部跳转时的交互流程
>
> - 后台"展示规则"（展示时间限制 / 展示客群限制）控制移动端权益列表的可见性
>
> - 后台"领取规则"（领取时间限制 / 领取客群限制）控制移动端权益详情页的领取校验；**领取客群统一由后台【发放计划】维护，未发放的权益移动端不展示**
>
> - 后台"显示页面"（权益首页/列表页、组装页）决定权益在移动端哪些页面展示
>
> - 后台"调整显示顺序"决定权益在移动端权益首页/列表中的展示顺序
>
> - 后台"分享设置"决定权益是否支持分享及分享内容（分享名称、分享图片）
>
## 1\. 我的权益
### 1.1 权益列表
展示顺序：先展示借记卡权益，再展示信用卡权益，最后是微信立减金入口（置底）
**（1）借记卡权益（新增）**
- **数据来源：** 后台权益商品列表中需同时满足：
- 商品状态：已上架
- 商品类型：不为微信立减金（微信立减金统一在"我的立减金"入口跳转展示）
- 展示时间限制：未开启 或 当前时间在后台配置的展示开始时间～展示结束时间范围内
- 展示客群限制：未开启 或 用户命中后台配置的客群标签ID
- 显示页面：后台配置了"权益首页/列表页 = 显示"
- 奖励点：如果权益商品开启了领取客群限制，需要判断用户的的该科目是否奖励点>0，如果等于0不展示
- **列表字段**
- 权益列表图标（取后台"权益列表图标"字段）
- 权益名称（取后台"权益名称"字段）
- **列表顺序：** 按照后台"调整显示顺序"排列（后台可通过列表【更多 → 调整显示顺序】调整）。
- **列表跳转** 根据后台【是否权益平台兑换】+【商品类型】+【是否有详情页】判断：
- **是否权益平台兑换=是（券码）：** 跳转到权益详情页
- **是否权益平台兑换=否，是否有详情页=没有：** 点击直接从列表跳转第三方链接
- 根据后台配置的【外部权益链接】类型判断跳转交互：
- **h5链接：** 弹窗提示
- **标题：** 您正在离开汇丰中国
- **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
- **操作**
- **取消：** 关闭弹窗
- **继续前往：** 跳转后台配置的h5链接
- **小程序链接：** 弹窗提示
- **标题：** 您正在离开汇丰中国
- **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
- **操作**
- **取消：** 关闭弹窗
- **继续前往：** 跳转后台配置的微信小程序（使用小程序appid + 页面地址）
- **太古地产：** 点击后弹出授权提醒
- 勾选同意并**确认**后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。
- **点击取消：** 关闭授权提醒。
- **龙腾：** 点击后弹出授权提醒
- 勾选同意并**确认**后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。
- **点击取消：** 关闭授权提醒。
**（2）信用卡权益（现有）**
通过营销提供的接口查询：若客户未达标，展示【待解锁】；若科目已达标，展示剩余可用次数（０次也展示）。
**（3）微信立减金（新增）**
底部固定展示微信立减金入口，点击跳转至微信立减金列表页面。
### 1.2 我的权益
展示顺序：
1. 是否权益平台兑换=是的券码权益（未过期）。
2. 信用卡权益。
3. 是否权益平台兑换=是的券码权益（已失效）。
筛选项：
- 全部
- 可使用：未过期
- 已失效
**（1）券码权益（未过期）**
- **列表字段**
- 权益列表图标（取"权益图片"字段）
- 权益名称（取"权益名称"字段）
- 可用次数
- **列表顺序**
- 领取时间倒序展示
- **跳转链接**
- 跳转订单详情页
**（2）信用卡权益**
- **列表字段**
- 权益列表图标（取后台"权益列表图标"字段）
- 权益名称（取后台"权益名称"字段）
- 权益副标题（取后台"权益副标题"字段，为空则不展示）
- **列表顺序**
- 领取时间倒序展示
- **跳转链接**
- 跳转订单详情页
**（3）券码权益（已失效）**
- **列表字段**
- 权益列表图标（取后台"权益列表图标"字段）
- 权益名称（取后台"权益名称"字段）
- **列表顺序**
- 领取时间倒序展示
- **跳转链接**
- 跳转订单详情页
## 2\. 权益详情
> 仅是否权益平台兑换=是的权益，以及是否权益平台兑换=否且是否有详情页=有的权益会进入此页面。
**（1）详情页内容**
- **权益主图：** 取后台"权益主图"字段
- **权益名称：** 取后台"权益名称"字段，超出换行展示
- **权益介绍：** 取后台"权益介绍"字段，非富文本，样式固定。图中卡片中权益名称下方内容
- **权益有效期：** 取后台"权益有效期"字段
- 取发放计划字段：
- 固定日期：【开始日期】-【结束日期】
- 相对日期：领取后 x 天内有效
- 自定义：显示自定义输入的内容
- **单客户权益数量（无领取限制则不显示）：**x 次（整个周期）、月度 x 次、季度 x 次、年度 x 次
- **权益内容：** 取后台"权益内容"字段，富文本展示，图中卡片下方的内容。PDF链接需支持点击打开预览查看，不需要支持下载。
- **权益说明：** 取后台"权益说明"字段，富文本展示。PDF链接需支持点击打开预览查看，不需要支持下载。
- **按钮：** 根据后台"领取规则"中的领取时间限制判断
- **开启了领取时间限制且未到领取开始时间：** 显示【未开始】，按钮无法点击
- **开启了领取时间限制且超过领取结束时间：** 显示【已失效】，按钮无法点击
- **其他：** 显示【领取权益】
**（2）领取权益**
点击【领取权益】按以下顺序校验领取规则：
**校验顺序：先校验发放计划 → 再校验领取客群规则**
> 注意：领取客群统一由后台【发放计划】维护。未在发放计划中发放给当前用户的权益，移动端不展示领取入口。用户在权益详情页点击领取时，需校验该用户是否在发放计划的客群范围内。
**规则校验失败提示：**
- **领取客群不满足时：** 展示后台配置的不满足提示
- 内容：取后台"领取客群限制-不满足提示-提示内容"
- 按钮文案：取后台"领取客群限制-不满足提示-跳转按钮文案"
- 按钮跳转：取后台"领取客群限制-不满足提示-跳转按钮链接"
**规则校验成功，处理逻辑分两种情况：**
**第一种：是否权益平台兑换=是**
领取成功提示：
- **内容：** 尊敬的客户，您已成功领取权益
- **按钮文案：** 取后台配置的"领取成功按钮文案"（默认值："马上去使用"）
- **按钮跳转：** 跳转权益订单详情页
**第二种：是否权益平台兑换=否，是否有详情页=有**
根据后台配置的【外部权益链接】类型判断跳转交互：
- **h5链接：** 弹窗提示
- **标题：** 您正在离开汇丰中国
- **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
- **操作**
- **取消：** 关闭弹窗
- **继续前往：** 跳转后台配置的h5链接
- **小程序链接：** 弹窗提示
- **标题：** 您正在离开汇丰中国
- **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
- **操作**
- **取消：** 关闭弹窗
- **继续前往：** 跳转后台配置的微信小程序（使用小程序appid + 页面地址）
- **太古地产：** 点击后弹出授权提醒
- 勾选同意并**确认**后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。
- **点击取消：** 关闭授权提醒。
- **龙腾：** 点击后弹出授权提醒
- 勾选同意并**确认**后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。
- **点击取消：** 关闭授权提醒。
## 3\. 权益订单详情
> 仅【券码】类型（是否权益平台兑换=是，商品类型=券码）领取成功后可进入此页面。
- 兑换卡号：默认为掩码状态，点击右侧复制按钮可复制
- 兑换密钥：默认为掩码状态，点击右侧复制按钮可复制
- 操作：
- 隐藏：点击后兑换卡号和兑换密钥为掩码状态，卡号和密钥默认为掩码
- 显示：点击后变成明文显示
- 使用按钮：按钮文案取后台配置的"领取成功按钮文案"（默认值："马上去使用"），点击跳转使用链接
## 4\. 我的立减金
> 微信立减金的后台配置为**是否权益平台兑换=是，商品类型=微信立减金**。后台在添加权益时选择"微信立减金"类型，从荣数商品池中选择具体的立减金商品（如"微信立减金 10元"等），自动回填商品信息。
逻辑：
- 查询到openid→调接口→领取成功
- 查询不到openid、接口失败异常情况：系统异常
（1）商品展示信息
- 权益图片：取后台"权益列表图标"字段
- 商品名称：取后台"权益名称"字段
- 副标题描述：取后台"权益副标题"字段
- 有效期：取SIP固定日期模式的有效期结束时间
- 按钮名称：根据3种状态分别展示
- 未领取：立即领取，点击领取该微信立减金
- 已领取：已领取，点击进入权益商品详情
- 已过期：已过期，不可点击
今日到期：已领取状态下，有效期结束日 = 当前日。
（2）进入页面，默认展示客户名下所有 未领取、已领取、已过期的不同面值立减金。
- 未领取：客户有权益点 且 有效期结束时间 < 当前时间；
- 已领取：实质是客户的立减金订单，有效期结束时间 < 当前时间；
- 已过期：有效期结束时间 >= 当前时间。
（3）展示顺序按照：未领取->已领取->已过期
- 未领取：按照权益点有效期结束时间，先到期先展示；
- 已领取：按照权益下单时间，先下单先展示；
- 已过期：按照权益点有效期结束时间，先到期先展示。
（4）页面支持筛选不同状态的商品；不同筛选状态下，没有商品信息，则展示"暂无立减金"。
（5）点击【点击领取】
① 调用行内接口，拿用户行内客户号查询用户openId。
② 调用SIP订单创建接口。若是立减金类型商品，下单必传openId。
③ SIP通过异步通知接口告诉商城下单成功。
④ 当 查询openId成功 且 异步通知成功后，则状态发生变化【点击领取】->【已领取】；否则页面toast提示"**系统异常，请联系客服人员**"。
⑤ 接口文档：[https://www.yuque.com/huadengchushang-eylqg/hfe0kc/wpsd1p?singleDoc#43731183](https://www.yuque.com/huadengchushang-eylqg/hfe0kc/wpsd1p?singleDoc#43731183) 密码：th38