**与后台的关联说明：**

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

## 1\. 我的权益

### 1.1 权益列表

![|70%](../../../../../.resources/image-1776678669459.png)

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

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

-   **数据来源：** 后台权益商品列表中需同时满足：
    
    -   商品状态：已上架
        
    -   商品类型：不为微信立减金（微信立减金统一在"我的立减金"入口跳转展示）
        
    -   展示时间限制：未开启 或 当前时间在后台配置的展示开始时间～展示结束时间范围内
        
    -   展示客群限制：未开启 或 用户命中后台配置的客群标签ID
        
    -   显示页面：后台配置了"权益首页/列表页 = 显示"
        
    -   奖励点：如果权益商品开启了领取客群限制，需要判断用户的的该科目是否奖励点>0，如果等于0不展示
        
-   **列表字段**
    
    -   权益列表图标（取后台"权益列表图标"字段）
        
    -   权益名称（取后台"权益名称"字段）
        
-   **列表顺序：** 按照后台"调整显示顺序"排列（后台可通过列表【更多 → 调整显示顺序】调整）。
    
-   **列表跳转** 根据后台【是否权益平台兑换】+【商品类型】+【是否有详情页】判断：
    
    -   **是否权益平台兑换=是（券码）：** 跳转到权益详情页
        
    -   **是否权益平台兑换=否，是否有详情页=没有：** 点击直接从列表跳转第三方链接
        
        -   根据后台配置的【外部权益链接】类型判断跳转交互：
            
        -   **h5链接：** 弹窗提示
            
            -   **标题：** 您正在离开汇丰中国
                
            -   **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
                
            -   **操作**
                
                -   **取消：** 关闭弹窗
                    
                -   **继续前往：** 跳转后台配置的h5链接
                    
                    ![|42%](../../../../../.resources/image-1776678703451.png)
        -   **小程序链接：** 弹窗提示
            
            -   **标题：** 您正在离开汇丰中国
                
            -   **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
                
            -   **操作**
                
                -   **取消：** 关闭弹窗
                    
                -   **继续前往：** 跳转后台配置的微信小程序（使用小程序appid + 页面地址）
                    
        -   **太古地产：** 点击后弹出授权提醒
            
            -   勾选同意并**确认**后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。
                
            -   **点击取消：** 关闭授权提醒。
                
                <br>
                
                ![](../../../../../.resources/image-1776678728870.png)
                
                <br>
                
                ![|45%](../../../../../.resources/image-1776678755981.png)
-   **龙腾：** 点击后弹出授权提醒
    
    -   勾选同意并**确认**后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。
        
    -   **点击取消：** 关闭授权提醒。
        
        ![|46%](../../../../../.resources/image-1776678775726.png)

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

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

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

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

### 1.2 我的权益

展示顺序：

1.  是否权益平台兑换=是的券码权益（未过期）。
    
2.  信用卡权益。
    
3.  是否权益平台兑换=是的券码权益（已失效）。
    

筛选项：

-   全部
    
-   可使用：未过期
    
-   已失效
    

![](../../../../../.resources/image-1776678841917.png)

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

-   **列表字段**
    
    -   权益列表图标（取"权益图片"字段）
        
    -   权益名称（取"权益名称"字段）
        
    -   可用次数
        
-   **列表顺序**
    
    -   领取时间倒序展示
        
-   **跳转链接**
    
    -   跳转订单详情页
        

**（2）信用卡权益**

-   **列表字段**
    
    -   权益列表图标（取后台"权益列表图标"字段）
        
    -   权益名称（取后台"权益名称"字段）
        
    -   权益副标题（取后台"权益副标题"字段，为空则不展示）
        
-   **列表顺序**
    
    -   领取时间倒序展示
        
-   **跳转链接**
    
    -   跳转订单详情页
        

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

-   **列表字段**
    
    -   权益列表图标（取后台"权益列表图标"字段）
        
    -   权益名称（取后台"权益名称"字段）
        
-   **列表顺序**
    
    -   领取时间倒序展示
        
-   **跳转链接**
    
    -   跳转订单详情页
        

## 2\. 权益详情

> 仅是否权益平台兑换=是的权益，以及是否权益平台兑换=否且是否有详情页=有的权益会进入此页面。

**（1）详情页内容**

-   **权益主图：** 取后台"权益主图"字段
    
-   **权益名称：** 取后台"权益名称"字段，超出换行展示
    
-   **权益介绍：** 取后台"权益介绍"字段，非富文本，样式固定。图中卡片中权益名称下方内容
    
-   **权益有效期：** 取后台"权益有效期"字段
    
    -   取发放计划字段：
        
        -   固定日期：【开始日期】-【结束日期】
            
        -   相对日期：领取后 x 天内有效
            
    -   自定义：显示自定义输入的内容
        
-   **单客户权益数量（无领取限制则不显示）：**x 次（整个周期）、月度 x 次、季度 x 次、年度 x 次
    
-   **权益内容：** 取后台"权益内容"字段，富文本展示，图中卡片下方的内容。PDF链接需支持点击打开预览查看，不需要支持下载。
    
-   **权益说明：** 取后台"权益说明"字段，富文本展示。PDF链接需支持点击打开预览查看，不需要支持下载。
    
-   **按钮：** 根据后台"领取规则"中的领取时间限制判断
    
    -   **开启了领取时间限制且未到领取开始时间：** 显示【未开始】，按钮无法点击
        
    -   **开启了领取时间限制且超过领取结束时间：** 显示【已失效】，按钮无法点击
        
-   **其他：** 显示【领取权益】
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    <br>
    
    ![|50%](../../../../../.resources/image-1776678923546.png)![|50%](../../../../../.resources/image-1776678942001.png)

**（2）领取权益**

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

**校验顺序：先校验发放计划 → 再校验领取客群规则**

> 注意：领取客群统一由后台【发放计划】维护。未在发放计划中发放给当前用户的权益，移动端不展示领取入口。用户在权益详情页点击领取时，需校验该用户是否在发放计划的客群范围内。

**规则校验失败提示：**

-   **领取客群不满足时：** 展示后台配置的不满足提示
    
    -   内容：取后台"领取客群限制-不满足提示-提示内容"
        
    -   按钮文案：取后台"领取客群限制-不满足提示-跳转按钮文案"
        
    -   按钮跳转：取后台"领取客群限制-不满足提示-跳转按钮链接"
        

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

**第一种：是否权益平台兑换=是**

领取成功提示：

-   **内容：** 尊敬的客户，您已成功领取权益
    
-   **按钮文案：** 取后台配置的"领取成功按钮文案"（默认值："马上去使用"）
    
-   **按钮跳转：** 跳转权益订单详情页
    

**第二种：是否权益平台兑换=否，是否有详情页=有**

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

-   **h5链接：** 弹窗提示
    
    -   **标题：** 您正在离开汇丰中国
        
    -   **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
        
    -   **操作**
        
        -   **取消：** 关闭弹窗
            
        -   **继续前往：** 跳转后台配置的h5链接
            
            ![|48%](../../../../../.resources/image-1776679010497.png)
-   **小程序链接：** 弹窗提示
    
    -   **标题：** 您正在离开汇丰中国
        
    -   **描述：** 请注意，外部网站的政策与我们网站的条款和条件以及隐私政策不同。将在新浏览器窗口或选项卡中打开下一个网站。
        
    -   **操作**
        
        -   **取消：** 关闭弹窗
            
        -   **继续前往：** 跳转后台配置的微信小程序（使用小程序appid + 页面地址）
            
-   **太古地产：** 点击后弹出授权提醒
    
    -   勾选同意并**确认**后，显示离开提示，点击确认时调用太古地产接口，然后跳转至后端返回的太古地产免登地址。
        
    -   **点击取消：** 关闭授权提醒。
        
        ![](../../../../../.resources/image-1776679026345.png)
-   **龙腾：** 点击后弹出授权提醒
    
    -   勾选同意并**确认**后，显示离开提示，点击确认时调用龙腾接口，然后跳转至后端返回的龙腾免登地址。
        
    -   **点击取消：** 关闭授权提醒。
        
        ![|45%](../../../../../.resources/image-1776679039096.png)

## 3\. 权益订单详情

> 仅【券码】类型（是否权益平台兑换=是，商品类型=券码）领取成功后可进入此页面。

-   兑换卡号：默认为掩码状态，点击右侧复制按钮可复制
    
-   兑换密钥：默认为掩码状态，点击右侧复制按钮可复制
    
-   操作：
    
    -   隐藏：点击后兑换卡号和兑换密钥为掩码状态，卡号和密钥默认为掩码
        
    -   显示：点击后变成明文显示
        
-   使用按钮：按钮文案取后台配置的"领取成功按钮文案"（默认值："马上去使用"），点击跳转使用链接
    

![](../../../../../.resources/image-1776679076106.png)

## 4\. 我的立减金

> 微信立减金的后台配置为**是否权益平台兑换=是，商品类型=微信立减金**。后台在添加权益时选择"微信立减金"类型，从荣数商品池中选择具体的立减金商品（如"微信立减金 10元"等），自动回填商品信息。

![|40%](../../../../../.resources/image-1776679101444.png)

逻辑：

-   查询到openid→调接口→领取成功
    
-   查询不到openid、接口失败异常情况：系统异常
    

（1）商品展示信息

-   权益图片：取后台"权益列表图标"字段
    
-   商品名称：取后台"权益名称"字段
    
-   副标题描述：取后台"权益副标题"字段
    
-   有效期：取SIP固定日期模式的有效期结束时间
    
-   按钮名称：根据3种状态分别展示
    
    -   未领取：立即领取，点击领取该微信立减金
        
    -   已领取：已领取，点击进入权益商品详情
        
    -   已过期：已过期，不可点击
        

今日到期：已领取状态下，有效期结束日 = 当前日。

（2）进入页面，默认展示客户名下所有 未领取、已领取、已过期的不同面值立减金。

-   未领取：客户有权益点 且 有效期结束时间 < 当前时间；
    
-   已领取：实质是客户的立减金订单，有效期结束时间 < 当前时间；
    
-   已过期：有效期结束时间 >= 当前时间。
    

（3）展示顺序按照：未领取->已领取->已过期

-   未领取：按照权益点有效期结束时间，先到期先展示；
    
-   已领取：按照权益下单时间，先下单先展示；
    
-   已过期：按照权益点有效期结束时间，先到期先展示。
    

（4）页面支持筛选不同状态的商品；不同筛选状态下，没有商品信息，则展示"暂无立减金"。

![](../../../../../.resources/image-1776679143290.png)

（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