橙分期重点问题优化
tags: #需求
- 需求链接https://tapd.tool.bestpay.net/tapd_fe/56339215/story/detail/1156339215001205579
一、变更日志
| 时间 | 版本号 | 变更人 | 主要变更内容 |
|---|---|---|---|
| 1.0 | 陈虹如 | 新建 |
二、文档说明
需求内容
3.1 0428 版本需求
3.1.1 套餐选择逻辑优化： @俊俊
套餐配置置顶后，套餐类型过滤失效，本期修复bug
3.1.2 人脸升级开关调整 @永涛
客户端预计4月底全面关闭老人脸，为了防止未配置情况，本次调整开关：
新地市开关名 ： 橙分期端内人脸升级开关
调整为 ：
- 未配置时，走升级后人脸 【本次调整】
- 配置为关时：走老人脸 【老逻辑】
- 配置为开时：走升级后人脸 【老逻辑】
3.1.3 统一供货通知山东省内字段调整 @永涛
原工单：
https://jira-new.bestpay.com.cn/browse/XQYFGL-215489
省侧反馈，之前告诉我们的同步字段给反了，需要我们更换一下调整后：
- offerId 取 mainOfferInfo 的 offerNbr
- choiceOfferId 取 contractOfferInfo 的 offerNbr ，若为空取 mainOfferInfo 的 offerNbr
3.1.4 福利中心页面，支持链接直接跳转@陈顺玉
新增永久短信短链，可以直接通过短信，跳转至 翼支付端内-橙分期子应用-福利中心 页面
3.1.5 微信小程序，新增 「订单竣工」 功能@陈顺玉
背景：根据目前商服咨询，部分情况下，双录/竣工人脸 在端内有些问题，本次新增营业员小程序竣工功能入口作为竣工能力在端外的补充（现有小程序竣工功能，但是营业员没有入口）
需求内容：
- 橙分期小程序 - 我的页面 - 新增「订单竣工」按钮（只有营业员可见）
- 点击后，出现可竣工的订单列表（注意区分组合办单/一次办多单）
- 点击后，可进入竣工页面
*需注意，标题栏不要有闪屏
| | | |
3.1.6 先享合约，绑卡页面，文字修改@陈顺玉
客服反馈：【温馨提醒部分设计违约金扣费说明，灰色字体不醒目，难以做到有效提醒】
本次修改UI展示
| 现页面 | 优化后 |
|  | |
3.1.7浙江广发银行同步订单文件不校验冻结时间为空字段 @永涛
需求人 @梦菲
浙江广发同步订单业务目前同步的文件中出现冻结时间为空的数据，原因为直连业务省里无冻结时间信息
导致文件解析异常，无法将同步数据入库，影响订单统计。需要改配置，不校验冻结时间字段。
3.2 0513 版本需求
3.2.1 端内：确认支付页面，调整为默认走短信验证码 @陈顺玉
需求背景：
客户端支付整改后，设置支付密码需人脸验证，前端反馈流程繁琐。
为简化操作，端内调整为支持验证码确认支付（与现有小程序流程一致）。
新增产品配置中心开关：橙分期端内支付操作方式
开关标识：建议命名为「cfqDefaultPaymentConfirmType」（可根据系统规范调整）
| 开关值 | 确认支付方式 | 操作说明 |
|---|---|---|
| SMS | 短信验证码确认 | 用户操作时，系统发送短信验证码，用户输入正确验证码后，完成支付确认操作，与现有小程序流程完全一致。 |
| PAY_PASSWORD | 支付密码确认 | 现有流程。 |
| 产品配置中心未配置该开关（或开关值为空）时，默认采用「SMS」方式（短信验证码确认），确保流程顺畅，无需额外配置即可上线。若有问题也可通过开关随时关闭 |
验证码编码：SMS_TP_00000119
验证码内容：您本次操作的验证码是：{param},该验证码在使用后失效。
需特别注意：
- 数字键盘常驻页面，不能消失
- 输入完最后一位后，自动提交
- 提交后，如果不正确，自动清屏，需第一位输入
3.2.2 微信小程序优化 @陈顺玉
标题头闪烁问题定位&优化
如下图，微信小程序页面标题头会闪烁，本次需定位并优化
---->
- 本次优化，优先修改以下4个页面：
- 具体体验可参考点击 【设置】 功能
- 本次定位问题后，需形成前端规范，后续新页面开发避免类似情况
点击防抖优化
小程序内，先后点击2个按钮，系统会先后跳到2个页面。或点击同一按钮多次，会反复进入同一页面
本次增加防抖，点击后，显示loading，不可再点击其他位置。
3.2.3 微信小程序绑卡切换大厅绑卡-@钱耀华
4月15日上线 【小程序绑卡页面优化】
https://tapd.tool.bestpay.net/tapd_fe/56339215/story/detail/1156339215001180402
目前发现， 【银行卡质押流程中绑卡页面】【京东后链路绑卡页面】未修改，本次修改
3.2.4 微信小程序增加【更新身份证照片】功能@陈顺玉
背景：浙江使用微信小程序办单。碰到身份证照片反光等情况需要更新证件时，需下载翼支付
本次完善小程序功能
若用户已实名： 判断身份证号+姓名是否一致
1.不一致拦截
2.一致更新信息
https://h5.bestpay.cn/subapps/member-userauth-2c-h5/index.html#/pages/mineinfo/index?callBackUrl=xxx
3.2 0526 版本需求
3.2.1 微信小程序优化2期 @陈顺玉
标题头闪烁问题定位&优化2期
本次涉及页面：【订单详情】【生成办理方式】【办理方式选择】【人脸】【补充信息】【授信协议】【授信中】【授信结果】【协议】
| | | | |
| 订单详情 | 生成办理方式 | 办理方式选择 | 人脸 |
| | | | |
| 补充信息 | 授信协议 | 授信中 | 授信结果 | | | | |
| | | | | | | |
| 协议 | | | | | | | |
3.2.2 前置授信，页面优化@陈顺玉
之前只优化了正常流程，未优化前置授信，本次增加
- 实名页面，样式调整
- 绑卡页面，样式调整 + 有卡用户跳过绑卡
- 补充信息页面，样式调整
本次调整包括 端内H5 + 微信小程序
【UI图待补充】
3.2.3 增加图片压缩 ---0526版本
涉及页面：
1、微信小程序自主竣工页面
- 补录页面拍照图片页面
涉及图片类型：
- 手持告知书
- 手持终端
如图片拍摄上传后尺寸过大，需要进行压缩处理。
案例：19058192530，4月29日
稽核信息显示成功，用户前端失败。
3.3 0609 版本需求
3.3.1 安徽预竣工短信调整@陈顺玉
需求背景：目前安徽预竣工短信的失败内容参数为配置项，如下图
key：PRE_COMPLETE_SMS_FAIL_MSG_CFG_STR
但是在实际操作中，省侧的各种失败可以任意组合，目前可配置的长度不够
需求内容：优化现有配置逻辑，无需全部组合后配置，具体为：
新增，产品通用配置：
key：pre_complete_sms_fail_reasons_allowed_set
- 可预先配置允许的失败原因项（包含原因如下，用英文 ; 分割）。
| 未受理CRM红包 |
| 月返金额不一致 |
| 期数不一致 |
| crm串号不一致 |
| 自注册串号不一致 |
| 分期订单金额补贴超额 |
| 翼支付与CRM实名不一致 |
- 系统接收到省侧的原因组合（支持多个原因用 顿号、分隔符拼接），自动判断组合内的每一项是否都在预配置范围内。
- 全部通过则校验成功，可以发送短信参数。 未全部通过则使用默认提示：未完成稽核。
业务场景示例：
假设已配置以上7个配置 未受理CRM红包;月返金额不一致;期数不一致;crm串号不一致;自注册串号不一致;分期订单金额补贴超额;翼支付与CRM实名不一致;
| 输入示例（分隔符使用分号） | 预期结果 |
|---|---|
| “crm串号不一致” | 通过 |
| “crm串号不一致、期数不一致” | 通过 |
| “crm串号不一致、月返金额不一致、期数不一致” | 通过 |
| “crm串号不一致、姓名不一致” | 失败 |
| “crm串号不一致、身份证不一致” | 失败 |
- 异常边界：
- 空白字符：系统应自动去除原因项前后空格，避免因空格导致匹配失败。
- 大小写与全半角：转换为全半角、且忽略大小写
3.3.2 测评业务类型展示开关逻辑优化@陈顺玉
优化内容：
先判断总开关【测评业务类型展示开关】是否配置：未配置则不展示；
已配置则继续判断【新地市测评业务类型开关】和【代理商测评业务类型开关】
两者只要任意命中，就展示为可选择，否则展示但置灰不可选。
3.3.3 纯血鸿蒙选择支付宝业务时提示调整@陈顺玉
提示内容调整为：
纯血鸿蒙系统暂不支持唤起支付宝，请先取消当前订单，再使用支付宝扫码完成办理。
注意：toast使用上个版本最新开发的组件（toast不要截断内容、显示在屏幕中间、弹出期间不阻断其他操作
3.3.4 原3.2.1需求优化 @陈顺玉
目前短信验证码键盘用的是 定制化键盘，无法快捷读取验证码短信
本次调整为 系统原生键盘
3.4 0624 版本需求
3.4.1 安徽预竣工短信调整
短信模板编码：SMS_TP_00005476
短信内容：
调整内容：
2026年5月14日 修改为： 5月13日22时
3.4.2微信小程序点击优化
目前微信小程序，点击按钮后，需要等1-2秒后，才会跳转，端内无此问题。 本次研究并优化。
3.4.3 用户侧下载服务协议优化
用户侧—订单详情 ，支持用户协议发送到指定邮箱，但目前代码里面是写死的文件类型，只支持发送主协议和提前续约业务的补充协议，本次需支持发送附件套协议，且需要修改代码逻辑不要写死文件类型，需要可配置
3.5 0707 版本需求
3.5.1加急结清时，屏蔽结清短信
背景：河北省提出，他人代偿结清的订单（加急结清），不要给用户发短信。本次前端增加选择：
【通知用户订单已结清 - 默认不选中】
如果勾选了，才给用户发送结清短信，如果不勾选，不给用户发送
3.6 0724 版本需求
3.6.1 视频双录，支持倍速配置
意愿核身播报加速配置化
- 背景：当前意愿核身播报语速（speed 参数）代码写死，省侧有加速诉求（1.2x / 1.5x），需要支持后台可配置。
- 关键结论：E证通和SDK两套接口的 speed 参数类型不同、枚举不同、默认值不同，必须分别配置。
SDK 意愿核身
- 接口：合作方初始化上传信息
- 参数名：speed
- 类型：String
| 值 | 语速 |
|---|---|
| -1 | 0.8x |
| 0 | 1.0x（默认） |
| 1 | 1.2x |
| 1.5 | 1.35x |
| 2 | 1.5x |
E证通 意愿核身
- 接口：数据结构文档
- 参数位置：GetEidTokenConfig.Speed / RuleIdConfig.Speed
- 类型：Integer
| 值 | 语速 |
|---|---|
| 0 | 智能语速（根据文案长度自动调整，默认） |
| 1 | 固定 1.0x |
| 2 | 固定 1.2x |
| 3 | 固定 1.5x |
| 需求描述 | |
| 在产品通用配置新增「意愿核身播报语速」配置，E证通和SDK各自独立，speed 从硬编码改为读配置。 | |
| 配置项设计 |
| 配置项 | key | value | 默认值 | 可选值（不做限制，随便写） |
|---|---|---|---|---|
| SDK意愿核身-播报语速 | tencent_faceid_intention_sdk_rule | { "speed": "2" } | 0 (1.0x) | -1 / 0 / 1 / 1.5 / 2 |
| E证通意愿核身-播报语速 | - tencent_faceid_intention_eid_rule | { "speed": "3" } 带不带""都能生效 | 0 (智能) | 0 / 1 / 2 / 3 |
从 Redis 取出 SDK 的 speed 后，转 String
取出 E证通的 speed 后，转 Integer
容错逻辑：
- Key 不存在 → 使用代码默认值
- Key 存在，但 JSON 解析失败或无 speed字段 → 使用代码默认值。
- speed值非法（如 SDK 配了 3，EID 配了 5）→ 使用代码默认值，并记录 Error 日志。
验收标准
- Redis 中设置 tencent_faceid_intention_sdk_rule{ "speed": "2" } 后，SDK 播报语速变为 1.5x
- Redis 中设置 tencent_faceid_intention_eid_rule { "speed": "3" } 后，E证通语速变为固定 1.5x
- key / speed 不存在时、非法时 各自走默认值，不影响现有业务