Startsida Utforska Hjälp
Logga in
fade
/
rongshu
1
0
Fork 0
Filer Ärenden 0 Pull-förfrågningar 0 Wiki
Träd: 7c308d20cb
Grenar Taggar
rongshu
/
prd
/
汇丰银行
/
汇丰借记卡权益.md

汇丰借记卡权益.md 21 KB
Historik Rå

一、需求背景

汇丰当前只有信用卡权益，希望支持全行权益，提升用户活跃度。

二、需求列表

（一）后台

入口：定制功能—>汇丰银行

权益商品管理

  1. 权益添加（两步骤向导：填写商品信息→设置规则）

  2. 权益编辑

  3. 权益查看

  4. 权益列表

  5. 审核

  6. 下架

（二）移动端

  1. 权益主页

  2. 权益详情

  3. 权益订单详情

  4. 我的立减金

三、需求详述

（一）后台

菜单入口：liso 定制功能-汇丰银行

1. 添加权益商品

添加权益商品采用两步骤向导：填写商品信息 → 设置规则。

权益商品按商品来源分为两类：银行自有和第三方。

  • 商品来源为"银行自有"时，填写商品信息步骤包含价格信息区域；

  • 商品来源为"第三方"时，不展示价格信息。

步骤一：填写商品信息

1.1 公共字段

字段名称 字段类型 是否必填 说明
商品来源 单选按钮组 是 银行自有 / 第三方，默认选择"银行自有"。

选择后表单字段根据来源类型动态展示。
商户名称 下拉选择框 是 仅当商品来源为"银行自有"时显示，与商品来源同行展示。支持搜索筛选。

1.2 银行自有

当商品来源为"银行自有"时，展示以下字段：

字段名称 字段类型 是否必填 说明
SKU编号 下拉选择框 是 选择关联的商品SKU。
1. 输入sku编号
2. 查询商城机构定价包含汇丰银行的SIP渠道银行自有商品，按照"商品名称-SKU编号"在列表回显，如果无结果显示"无相关商品"。输入框支持清空。
3. 选择商品自动填充：商品名称→权益名称、商品图片→权益列表图标、商户价格信息
权益名称 文本输入框 是 最长可输入40个字符
权益副标题 文本输入框 否 权益的副标题说明，最长可输入40个字符
权益列表图标 图片上传 是 上传列表权益图标图片，只能传一张
权益主图 图片上传 是 上传权益主图图片，只能传一张
权益概述 富文本输入框 是 权益的详细内容说明，最长500个字符
权益详情 富文本输入框 是 权益的使用说明，最长1000个字符
下单成功短信 开关 + 下拉选择框 否 该字段单独占一行。默认关闭，开启后在开关下方显示"短信模板"下拉选择框，选择模板后回显模板内容（只读预览）。关闭则不发送短信。
字段需显示tips：此模板为权益支付成功，发送给持卡人的短信模板；开启后需选择短信模板，关闭则不发送短信。 占位符如下 ： 商品名称：${productName} ； 结束日期：${expireDate} ； 卡号: ${exchangeNum} ；卡密 ：${exchangePwd}；券码路径:${qrCodeDownPaths}。
短信模板下拉选项来源：已配置的短信模板列表（模板 ID + 模板名称），保存时存储选中的模板 ID。
领取成功按钮文案 文本输入框 是 领取成功后按钮显示的文案，默认值："马上去使用"

价格信息

当为银行自有且选择了sku编号时显示

字段名称 字段类型 是否必填 说明
科目号 选择框 是 可输入的选择框。

选择框中展示科目号。

1.3 外部

当商品来源为"第三方"时，先选择外部商品链接和跳转触发页，再根据跳转触发页展示不同字段：

字段名称 字段类型 是否必填 说明
外部商品链接 下拉选择框 是 可选值：太古地产、龙腾、自定义。
选择"自定义"时，显示自定义链接输入框（必填，最长400个字符）。
跳转触发页 下拉选择框 是 可选值：权益列表页、权益详情页。
根据选择展示不同的表单字段。

（1）跳转触发页 = 权益列表页 时，展示以下字段：

字段名称 字段类型 是否必填 说明
权益名称 文本输入框 是 最长可输入40个字符
权益副标题 文本输入框 否 权益的副标题说明，最长可输入40个字符
权益列表图标 图片上传 是 上传权益图标图片，只能传一张

（2）跳转触发页 = 权益详情页 时，展示以下字段：

字段名称 字段类型 是否必填 说明
权益名称 文本输入框 是 最长可输入40个字符
权益副标题 文本输入框 否 权益的副标题说明，最长可输入40个字符
权益列表图标 图片上传 是 上传权益图标图片，只能传一张
权益主图 图片上传 是 上传权益主图图片，只能传一张
权益概述 富文本输入框 是 权益的详细内容说明，最长500个字符
权益详情 富文本输入框 是 权益的使用说明，最长1000个字符

步骤二：设置规则

展示规则

字段名称 字段类型 是否必填 说明
展示时间限制 开关（Toggle） 否 默认关闭。开启后可配置展示的开始时间和结束时间，格式 Y-m-d H:i:s
展示客群限制 开关（Toggle） 否 默认关闭。开启后可选择客群标签ID（单选）

领取规则

字段名称 字段类型 是否必填 说明
领取时间限制 开关（Toggle） 否 默认关闭。开启后可配置领取的开始时间和结束时间，格式 Y-m-d H:i:s
领取客群限制 开关（Toggle） 否 默认关闭。
开启后可配置
• 标签：标签ID，必填，最长可输入50个字符
• 不满足提示
◦ 提示内容：必填，最长可输入200个字符
◦ 跳转按钮文案：必填，最长可输入10个字符
◦ 跳转按钮链接：必填，最长可输入200个字符

操作按钮

  • 上一步/下一步： 在步骤之间导航

  • 取消： 放弃当前操作，返回权益列表页

  • 提交： 在最后一步显示，校验必填项，通过后提交创建权益商品记录，状态变为【待审核】

2. 权益编辑

仅待审核、审核拒绝和已下架的权益商品可编辑。

与添加权益商品相比，除了【商品来源】不可编辑，其他均可编辑。

  • 取消： 放弃当前操作，返回权益列表页。

  • 保存： 校验必填项，通过后更新权益商品记录，状态变为【待审核】。




3. 权益查看

字段同权益编辑

  • 输入框和选择框禁用

  • 不展示取消和提交按钮。

4. 权益列表

（1）筛选条件

字段名称 字段类型 是否必填 说明
权益名称 文本输入框 否 模糊搜索权益名称
商品ID 文本输入框 否 精确匹配商品ID
SKU编号 文本输入框 否 精确匹配SKU编号
科目号 文本输入框 否 精确匹配科目号

（2）操作按钮

  • 查询：根据筛选条件查询权益列表

  • 重置：清空所有筛选条件

  • 添加权益商品：打开【权益添加】页面

（3）列表字段

字段名称 说明
操作 • 查看：查看权益详情
• 编辑：编辑权益信息
• 审核：审核状态为待审核时显示
• 下架：审核状态为审核通过或已上架时显示，点击下架该权益
权益名称 权益的名称
审核状态 待审核、审核通过、审核拒绝、已上架、已下架
商品来源 银行自有 / 第三方
外部商品链接 外部商品链接类型（太古地产/龙腾/自定义），银行自有时显示"-"
跳转触发页 权益列表页 / 权益详情页，银行自有时显示"-"
商品ID 商品ID
SKU编号 关联的商品SKU编号
商户名称 商品商户名称
审核人 执行审核的操作人
审核时间 审核操作的时间

（4）分页

  • 默认每页显示 20 条记录

  • 支持翻页：首页、上一页、下一页、末页、跳转至指定页

5. 权益审核

当权益商品状态为【待审核】时，在列表展示【审核】操作按钮。

展示的字段同【查看权益】，底下增加操作

  • 审核拒绝：

    • 点击后弹窗二次确认，确认后该权益商品状态变为【审核拒绝】。

  • 审核通过：

    • 点击后弹窗二次确认，确认后该权益商品状态变为【已上架】。

6. 权益下架

当权益商品为【审核通过】或【已上架】时在列表展示按钮，点击后弹窗提示【确定要下架权益"XXX"吗？】

  • 确定：将该权益商品状态变为【已下架】，前台不再展示且无法兑换下单

  • 取消：关闭弹窗

（二）移动端

与后台的关联说明：

  • 移动端根据后台"商品来源"和"跳转触发页"两个字段组合判断跳转逻辑

  • 后台"外部商品链接"字段（太古地产/龙腾/自定义）决定外部跳转时的交互流程

  • 后台"展示规则"控制移动端权益列表的可见性

  • 后台"领取规则"控制移动端权益详情页的领取校验

1. 权益主页（积木侧搭建）

新增借记卡权益（通过积木组件百变导航配置）

2. 我的权益

2.1 权益列表

展示顺序：先展示借记卡权益，再展示信用卡权益，最后是微信立减金（置底）

（1）借记卡权益（新增）

  • 数据来源： 后台权益商品列表中需同时满足：

    • 商品状态：已上架

    • 商品类型：不为微信立减金

    • 展示时间限制：未开启 或 当前时间在后台配置的展示开始时间～展示结束时间范围内

    • 展示客群限制：未开启 或 用户命中后台配置的客群标签ID

  • 列表字段

    • 权益列表图标（取后台"权益列表图标"字段）

    • 权益名称（取后台"权益名称"字段）

  • 列表顺序： 按照审核通过时间从后往前排序展示。

  • 列表跳转 根据后台【商品来源】+【跳转触发页】判断：

    • 商品来源=银行自有： 跳转到权益详情页

    • 商品来源=第三方，跳转触发页=权益列表页： 点击跳转第三方链接

      • 根据后台配置的【外部商品链接】类型判断跳转交互：

      • 自定义： 弹窗提示

        • 标题： 您正在离开汇丰中国

        • 描述： 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。

        • 操作

          • 取消： 关闭弹窗

          • 继续前往： 跳转后台配置的自定义链接

      • 太古地产： 点击后弹出授权提醒

        • 勾选同意并确认后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。

        • 点击取消： 关闭授权提醒。




      • 龙腾： 点击后弹出授权提醒

        • 勾选同意并确认后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。

        • 点击取消： 关闭授权提醒。

（2）信用卡权益（现有）

通过营销提供的接口查询：若客户未达标，展示带解锁；若科目已达标，展示剩余可用次数（０次也展示）。

（3）微信立减金（新增）

底部固定展示微信立减金入口，点击跳转至微信立减金列表页面。

2.2 我的权益

展示顺序：先展示【商品来源为银行自有券码】（未过期），再展示【信用卡权益】，最后展示【商品来源为银行自有券码权益】（已失效）。

（1）券码权益（未过期）

  • 列表字段

    • 权益列表图标（取后台"权益列表图标"字段）

    • 权益名称（取后台"权益名称"字段）

    • 权益副标题（取后台"权益副标题"字段，为空则不展示）

  • 列表顺序

    • 按照券码有效期，先到期先展示

  • 跳转链接

    • 跳转订单详情页

（2）信用卡权益

通过营销提供的接口查询：若客户未达标，展示带解锁；若科目已达标，展示剩余可用次数（０次也展示）。

（3）券码权益（已失效）

  • 列表字段

    • 权益列表图标（取后台"权益列表图标"字段）

    • 权益名称（取后台"权益名称"字段）

  • 列表顺序

    • 按照券码有效期，最近到期先展示

    • 查询最近一年的到期订单

  • 跳转链接

    • 跳转订单详情页

3. 权益详情

仅商品来源=银行自有，以及商品来源=第三方且跳转触发页=权益详情页的权益会进入此页面。

（1）详情页内容

  • 权益主图： 取后台"权益主图"字段

  • 权益名称： 取后台"权益名称"字段，超出换行展示

  • 权益概述： 取后台"权益概述"字段，富文本展示，图中卡片中权益名称下方内容

  • 权益详情： 取后台"权益详情"字段，富文本展示，图中卡片下方的内容

  • 按钮： 根据后台"领取规则"中的领取时间限制判断

    • 开启了领取时间限制且未到领取开始时间： 显示【未开始】，按钮无法点击

    • 开启了领取时间限制且超过领取结束时间： 显示【已失效】，按钮无法点击

    • 其他： 显示【领取权益】




（2）领取权益

点击【领取权益】按以下顺序校验领取规则：

校验顺序：校验领取客群规则

规则校验失败提示：

  • 领取客群不满足时： 展示后台配置的不满足提示

    • 内容：取后台"领取客群限制-不满足提示-提示内容"

    • 按钮文案：取后台"领取客群限制-不满足提示-跳转按钮文案"

    • 按钮跳转：取后台"领取客群限制-不满足提示-跳转按钮链接"

规则校验成功，处理逻辑分两种情况：

第一种：商品来源=银行自有

领取成功提示：

  • 内容： 尊敬的客户，您已成功领取权益

  • 按钮文案： 取后台配置的"领取成功按钮文案"（默认值："马上去使用"）

  • 按钮跳转： 跳转权益订单详情页




第二种：商品来源=第三方，跳转触发页=权益详情页

根据后台配置的【外部商品链接】类型判断跳转交互：

  • 自定义： 弹窗提示

    • 标题： 您正在离开汇丰中国

    • 描述： 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。

    • 操作

      • 取消： 关闭弹窗

      • 继续前往： 跳转后台配置的自定义链接

  • 太古地产： 点击后弹出授权提醒

    • 勾选同意并确认后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。

    • 点击取消： 关闭授权提醒。

  • 龙腾： 点击后弹出授权提醒

    • 勾选同意并确认后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。

    • 点击取消： 关闭授权提醒。

4. 权益订单详情

仅【券码】类型（商品来源=银行自有）领取成功后可进入此页面。

  • 兑换卡号：默认为掩码状态，点击右侧复制按钮可复制

  • 兑换密钥：默认为掩码状态，点击右侧复制按钮可复制

  • 操作：

    • 隐藏：点击后兑换卡号和兑换密钥为掩码状态，卡号和密钥默认为掩码

    • 显示：点击后变成明文显示

  • 使用按钮：按钮文案取后台配置的"领取成功按钮文案"（默认值："马上去使用"），点击跳转使用链接

5. 我的立减金

逻辑：

  • 查询到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