与后台的关联说明:
- 移动端根据后台"是否权益平台兑换"、"商品类型"和"是否有详情页"组合判断跳转逻辑
- 后台"是否权益平台兑换"分为两类:是(商品类型为券码或微信立减金)、否(第三方权益:太古地产/龙腾/h5链接/小程序链接)
- 后台"外部权益链接"字段(太古地产/龙腾/h5链接/小程序链接)决定外部跳转时的交互流程
- 后台"展示规则"(展示时间限制 / 展示客群限制)控制移动端权益列表的可见性
- 后台"领取规则"(领取时间限制 / 领取客群限制)控制移动端权益详情页的领取校验;领取客群统一由后台【发放计划】维护,未发放的权益移动端不展示
- 后台"显示页面"(权益首页/列表页、组装页)决定权益在移动端哪些页面展示
- 后台"调整显示顺序"决定权益在移动端权益首页/列表中的展示顺序
- 后台"分享设置"决定权益是否支持分享及分享内容(分享名称、分享图片)
1. 我的权益
1.1 权益列表

展示顺序:先展示借记卡权益,再展示信用卡权益,最后是微信立减金入口(置底)
(1)借记卡权益(新增)
(2)信用卡权益(现有)
通过营销提供的接口查询:若客户未达标,展示【待解锁】;若科目已达标,展示剩余可用次数(0次也展示)。
(3)微信立减金(新增)
底部固定展示微信立减金入口,点击跳转至微信立减金列表页面。
1.2 我的权益
展示顺序:
- 是否权益平台兑换=是的券码权益(未过期)。
- 信用卡权益。
- 是否权益平台兑换=是的券码权益(已失效)。
筛选项:

(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 密码:th38