现金贷增信提额 H5 需求文档

版本：V1.3
更新日期：2026-08-24
产品线：RocketCash（Nigeria / KasyKredit），不属于 RocketCash Ghana
MVP 交付：H5 原型、Figma 750px 独立 Frame、交互流程、配置与额度规则

涉及的版块

1、bns需要关注的内容：2、3、4、5、6、7
2、H5需要关注的内容：3.1、4、5、6、8、9
3、FCS 需要关注的内容：提供客户历史借据状态查询能力，确保可判断是否存在已结清及当前在贷借据

1. 背景与目标

面向至少存在一笔已结清借据、当前无在贷借据且当前可申请借款的存量用户，提供主动补充财务证明的入口。用户可在一次申请中添加一种或多种资料，提交后由风险审批重新评估授信总额度。本期首先服务风险样本收集与额度策略验证，增信结果不代表下一笔借款必然审批通过。

MVP 目标：

首页入口按可配置客群展示，仅至少存在一笔已结清借据、当前无在贷借据且符合申请资格的用户可进入；
本期默认支持银行流水、同业竞品额度、钱包流水、水电单；增信项由后台配置并支持动态增加，允许一次提交多个不同资料项；
同一资料类型允许重复提交，间隔可配置，初始为 7 个自然日；
用利益点、耗时预期、安全说明和上传质量提示提升用户提交意愿；
额度完全由风险审批与额度中心输出，H5 不计算、不承诺提额；
本次增信不修改已有借据，不主动降低现有额度。

2. MVP 范围

2.1 本期支持

首页提额入口：可提交、审批中、未命中隐藏；本期不增加“已审批”专属首页状态。
四类默认增信资料：
- 银行流水图片或 PDF；
- 同业竞品额度截图或 PDF；
- 钱包流水图片或 PDF；
- 近期水费单或电费单图片/PDF，用于辅助核验姓名或服务地址。
单次申请可添加 1–N 种不同资料，N 为当前客群可见且启用的增信项数量；已添加资料可替换。
每种资料独立计算重复提交冷却期，默认 7 天，服务端配置化。
文件上传、失败重试、安全检查、可读性校验和申请快照。
异步风险审批、状态恢复和结果触达。
提额成功、额度不变、资料需重传三类对客结果。

2.2 本期不支持

当前存在在贷借据的用户；
短信、Push 或外部渠道深链；
水电单 OCR 结构化识别或将上传结果表述为完成住址验证；
资料项级客群、按用户个性化推荐；
多文件、表单、授权跳转等非通用单文件增信项；
将首页入口改造成常驻功能；
文件安全检查的基础设施和工具选型，相关技术方案由 BNS/安全团队另行评审。

3. 用户准入与入口配置

入口是否展示及展示状态由服务端统一判断，H5 只按业务结果展示，不在本地圈选用户。入口配置至少支持总开关、入口客群、生效时间和失效时间。

基础资格：已登录、至少存在一笔已结清借据、当前无在贷借据、账户未冻结或注销，且当前可申请借款。

“有结清记录”以后端借据终态为准：至少一笔历史借据状态为 settled/paid_off，并存在有效结清时间；前端不依据还款金额或本地展示状态推断。
仅放款成功但尚未结清、部分还款、当前在贷、逾期、核销、取消或拒绝记录，均不能满足本期基础资格。
KYC 是否过期、具体风险标签等不由 H5 单独判断，统一包含在“当前可申请借款”的业务资格结果中。
首页入口展示和最终提交时均须重新确认资格；提交时不满足资格则不得创建提额申请或进入风险审批。
同一用户同时最多存在一笔审批中申请，审批完成前不能再次创建新申请。

MVP 不提供短信、Push 或外部渠道深链。用户直接访问 H5 地址、刷新或从历史页面返回时，仍须恢复登录状态并重新确认资格。

审批终态后的首页规则：本期不新增“已审批”专属首页状态，也不针对提额成功、额度不变分别设计首页卡片。结果在本次流程的结果页展示；用户返回首页后，入口继续按客群配置和实时资格展示。将提额入口改为常驻功能属于后续范围。

3.1 增信项后台配置

增信项列表由服务端返回，H5 不维护固定枚举。后台新增符合通用“文件上传型”协议的增信项后，可在不发布 H5 新版本的情况下展示。

本期资料类型编码统一为：bank_statement、other_lender_limit、wallet_statement、utility_bill。水费单和电费单均归入 utility_bill；类型启用后不得改名、删除或复用为其他资料。

配置能力	本期规则
展示内容	配置资料名称、说明、利益点、上传引导和多语言文案，不得承诺必然提额
图标	固定支持 `bank`、`lender`、`wallet`、`utility`、`file` 五种展示标识；未知或未配置时使用通用文件图标
上下架	人工开关开启且当前时间处于生效窗口内时，资料项才对新申请可见；任一条件不满足即不可新加
排序与推荐	支持排序；MVP 使用全局推荐项，默认银行流水，同一时间最多一个，不按用户个性化
文件要求	支持配置允许格式、大小上限、是否要求近期资料、近期月数和上传引导
重复提交间隔	默认 7 个自然日；按资料类型配置，规则见 5.2

配置与运行规则：

MVP 暂不支持资料项级客群，所有满足入口资格的用户看到同一组启用资料项，不使用 cust_level 对资料项进行二次分组。
方式页展示当前启用且位于生效窗口内的资料项，H5 按配置顺序渲染。
最终提交时须再次确认资料项仍可用，避免用户停留页面期间配置发生变化。
用户已加入篮子的增信项若在提交前下架，提交时提示“该资料项暂不可用”，移出该项并保留其他可提交项；不得整单静默失败。
最终提交时保存当次资料名称、文件要求、冷却间隔和配置版本。后台后续改名、调整冷却或下架，不追溯修改审批中及历史申请。
后台仅允许动态增加通用单文件上传型增信项；多文件、表单或授权跳转属于新交互，需另行立项。
已使用的资料类型只允许停用，不允许复用；后台变更需可审计。

4. 页面信息架构与视觉引导

页面/状态	核心内容	主操作
首页·可提交	“可能获得更高额度”、约 2 分钟、安全上传	Increase my limit
首页·审批中	已收到资料、会主动通知	View review
方式页·未选择	配置返回的增信项、利益点、推荐项、安全说明	选择资料
方式页·多项已添加	已添加数量、可继续添加/替换	Submit N items for review
方式页·冷却中	同项剩余天数，其他项仍可添加	选择其他可用项
上传页	上传质量提示、支持格式、安全边界	Add to my review
上传失败	原因、人话说明、保留重试入口	Try again
审批中	已收到的资料项、无需停留、通知说明	Back to home
审批中·再次进入	恢复原申请、已提交资料、提交时间、仍在审核	Back to home
结果·成功	前后总额度、已生效	Done
结果·不变	明确额度未降低	Done
结果·重传	明确不消耗冷却期	Upload a clearer file

引导原则：不承诺必然提额；强调“更多相关证明有助于理解财务状况”“约 2 分钟”“安全上传”；本期银行流水默认标记 Recommended，但推荐项以后端配置为准且不阻塞其他方式。

本期首页只区分可提交、审批中和隐藏三种状态，不新增“已审批”状态。提额成功、额度不变和资料需重传均在结果页表达；返回首页后重新按实时资格展示入口。

5. 页面交互流程

flowchart TD
    A["用户进入首页"] --> A1{"是否至少有一笔已结清借据"}
    A1 -->|"否"| C["不展示入口"]
    A1 -->|"是"| A2{"当前是否无在贷且可申请借款"}
    A2 -->|"否"| C
    A2 -->|"是"| B{"客群配置与账户状态"}
    B -->|"hidden"| C["不展示入口"]
    B -->|"reviewing"| D["View review"]
    B -->|"eligible"| E["Increase my limit"]
    D --> V["审批中恢复页：不展示资料选择、不允许重复提交"]
    E --> E1{"进入提额页时查询有效申请"}
    E1 -->|"无有效申请"| F0["拉取用户可见的启用增信项配置"]
    F0 --> F["增信方式页（动态渲染）"]
    E1 -->|"submitted / reviewing"| V
    E1 -->|"已有终态"| R
    F --> G{"资料项状态"}
    G -->|"可添加"| H["上传/选择文件"]
    G -->|"已添加"| I["替换文件或继续添加其他项"]
    G -->|"冷却中"| J["展示可再次提交时间，禁用该项"]
    H --> K{"文件校验"}
    K -->|"失败"| L["失败提示与重试"]
    K -->|"通过"| I
    I --> M["提交 1–N 个资料项"]
    M --> N["重新确认资格和资料项有效性并保存申请快照"]
    N --> O["按资料项开始重复提交冷却"]
    O --> P["异步调用风险审批"]
    P --> Q["审批中，可离开并恢复"]
    Q --> W["用户离开后再次点击入口或刷新页面"]
    W --> V
    V --> V1{"刷新原申请状态"}
    V1 -->|"仍在审批"| V
    V1 -->|"已完成"| R
    Q --> R{"审批与额度生效结果"}
    R -->|"increased"| S["提额成功"]
    R -->|"unchanged"| T["额度不变"]
    R -->|"resubmit_required"| U["立即重传，不消耗冷却期"]

5.1 多资料提交

方式页是资料篮子；每种类型最多一项，可在最终提交前替换。
用户可只提交一项，也可继续添加其他可用项后批量提交。
点击最终提交后生成一次申请，包含用户本次提交的所有资料项；风险审批读取同一申请快照。
每种 evidence_type 在同一资料篮子中最多一项；水电单不区分水费/电费为两个篮子项，均归入 utility_bill。
同一用户如已有已提交或审批中申请，不允许再次创建新申请；刷新、重复点击和弱网重试不得生成重复申请。

5.2 同项重复提交与 7 天冷却

冷却粒度为“同一用户 + 同一资料类型”，不同资料类型互不阻塞。
起算点：包含该资料项的申请最终提交成功时间；仅选择文件或上传成功但未最终提交不计时。
默认间隔为 7 个自然日，可按资料类型调整；提交时保存当次间隔，后续配置变更只影响新的提交。
H5 展示服务端给出的可再次提交时间或剩余天数，不在本地自行推算。
上传前或上传阶段失败时，资料未进入申请，不产生冷却。
风险明确返回 resubmit_required 时，只解除被退回资料项的冷却，并允许立即重传；提额成功或额度不变均保留正常冷却。
冷却期内该项禁用，但用户仍可提交其他未冷却资料。

5.3 上传与弱网

支持 PDF/JPG/PNG，单文件默认不超过 10 MB，限制由服务端返回。
水电单应能看到用户姓名或服务地址、供水/供电机构及近期账单日期。MVP 不以 OCR 识别成功作为提交条件，也不将水电单定义为已完成姓名或住址验证；风险审批将其作为辅助材料，无法核验时可返回需重传。
页面文案使用“帮助我们了解/确认”，不得使用“住址已验证”。OCR 结构化识别不属于本期范围。
上传前校验空文件、格式和大小；文件还须通过安全性、完整性和归属检查。未通过安全检查的文件不得进入申请，统一提示“文件无法使用，请更换文件”，不展示安全检查细节，不产生冷却，也不影响篮子中其他资料。
增加相同文件拦截：以文件内容是否相同作为最终判断依据，不能只比较文件名；改名后的相同文件仍须拦截。判重范围至少覆盖同一用户的当前有效提额申请。
若文件与当前篮子中的文件重复，提示 This file has already been added. Choose a different file.，保留当前已添加资料，不覆盖、不上传、不启动冷却期。
resubmit_required 场景若用户再次选择上次不可读的同一文件，也应拦截并提示上传更清晰或内容不同的文件。
上传完成和最终提交时均须再次判重；并发上传、改名文件或绕过前端均不能产生重复资料项。
单文件上传等待超过 60 秒视为本次上传超时，提示“网络不稳定，请重试”；保留本地已选文件名和其他已添加资料，由用户主动重试，不自动重复提交，且不产生冷却。
上传失败保留已选文件信息和重试入口；最终提交超时应先查询原申请结果，不直接新建申请。
用户离开审批页后可恢复；客户端不得因等待超时将 reviewing 变为失败。

5.4 审批中再次进入

显示审批中结果页，并按申请内的配置快照展示已提交资料名称；即使该增信项已在后台停用，也不得从审批中页面消失。

6. 业务状态

状态	含义	用户操作
`eligible`	可添加资料	选择一个或多个资料项
`ready`	已添加、未最终提交	替换/继续添加/提交
`cooldown`	同项未到再次提交时间	查看剩余时间，选择其他项
`uploading`	文件上传中	等待/重试
`upload_failed`	格式、大小、网络或安全检查未通过	更换文件/重试
`upload_timeout`	单文件上传等待超过 60 秒	手动重试
`submitted`	申请快照已落库	查看审批中
`reviewing`	风险审批处理中	返回首页/查询状态
`increased`	新额度已生效	查看新额度
`unchanged`	审批完成、额度未变	返回首页
`resubmit_required`	资料质量不足	立即重传该项

7. 额度变化规则

本期延续总额度覆盖方式，以最小改造完成增信提额：

风险审批是额度结果的唯一决策来源，H5 不计算、不拼接、不承诺提额金额。
风险审批输出建议授信总额度；额度生效后，以新总额度覆盖当前总额度，不将额度差再次累加。
本次增信不主动降低用户当前有效总额度。风险建议额度不高于当前额度时，结果为额度不变。
提额只影响后续可用授信，不修改已有借据本金、费用、期限、还款计划或账务。
同一审批结果重复处理时不得产生重复额度变更；额度差异记录仅用于审计。
额度生效成功后才展示提额成功；额度尚未完成生效时保持审批中，不得提前展示新额度。
额度不变结果仅在当前额度保持不变且本次提额额度已释放后展示；释放尚未完成时保持审批中。
额度不变结果页明确“当前额度未降低”“本次提额额度已释放”，并引导用户保持良好还款行为，以便后续额度评估；该引导不构成提额承诺。
资料需重传时不输出新的额度结果，并解除被退回资料项的冷却，用户可立即重新提交清晰或不同的文件。

8. 埋点

埋点 owner 为 RocketCash H5。页面曝光、点击与业务结果分开上报；页面事实取自当前 UI 状态，申请创建、风险审批和额度结果必须以可信业务结果为准，不得用按钮点击代替成功。

事件名	类型	页面/场景	唯一触发时机与业务含义	关键属性及来源	指标/漏斗
`credit_boost_entry_view`	view	首页入口 `credit_boost_home_entry`	入口实际进入可视区时每次页面生命周期一次；衡量入口覆盖	`entry_status`、`home_status` 来自页面业务状态；`audience_rule_id` 来自入口客群结果	入口覆盖人数、状态分布
`credit_boost_entry_click`	click	首页入口 `credit_boost_home_entry`	用户点击入口一次；衡量从首页进入提额流程的意愿	`entry_status` 来自点击时入口状态；`source_page`、`target_page` 为稳定页面编码	入口点击率、进入转化率
`credit_boost_methods_view`	view	方式页 `credit_boost_methods`	方式页成功展示时每次页面生命周期一次	`available_item_count`、`ready_item_count`、`cooldown_item_count` 来自页面状态；`config_version` 来自当前配置	方式页到达人数、可用资料分布
`credit_boost_item_add`	click	方式页 `credit_boost_methods`	资料成功加入篮子后一次；不是点击上传入口时上报	`evidence_type`、`config_version` 来自当前资料项；`ready_item_count` 来自加入后的篮子状态	各资料采用率、平均篮子项数
`credit_boost_item_blocked`	result	方式页/上传页	冷却、相同文件或安全检查实际阻断时一次	`evidence_type` 来自资料项；`blocked_reason` 使用 `cooldown/duplicate/security` 稳定分类；冷却时带 `remaining_days`	冷却阻断率、重复文件率、安全阻断率
`credit_boost_upload_result`	result	上传页 `credit_boost_upload`	单文件上传获得成功、失败或超时结果时一次	`evidence_type` 来自资料项；`result` 使用 `success/failed/timeout`；`error_reason` 使用脱敏稳定分类	上传成功率、超时率、失败原因分布
`credit_boost_submit_click`	click	方式页 `credit_boost_methods`	用户点击最终提交时一次，只表示发起提交	`item_count`、`evidence_types` 来自当前篮子；`session_id` 来自本次提额流程	发起提交人数、篮子深度
`credit_boost_submit_result`	result	方式页 `credit_boost_methods`	申请真实创建成功或失败后一次	`result` 来自真实申请状态；`item_count`、`evidence_types` 来自申请快照；失败时使用稳定脱敏原因	提交成功率、进入审批转化率
`credit_boost_review_view`	view	审批中页 `credit_boost_review`	审批中页成功展示时每次页面生命周期一次	`entry_mode` 使用 `first/revisit`；`submitted_item_count` 来自申请快照；`review_status` 来自业务状态	审批中再次进入率、状态停留
`credit_boost_result_view`	view	结果页 `credit_boost_result`	可信终态成功展示时每次结果一次	`result` 使用 `increased/unchanged/resubmit_required`；额度仅使用分档，不上报文件内容和原始金额	提额率、额度不变率、重传率

通用要求：

event_name、event_page 使用固定小写 snake_case，不拼接用户输入、金额、ID 或错误文本。
同一次提额旅程使用稳定 session_id 关联页面；只有存在真实业务追踪标识时才上报 trace_id。
禁止采集或展示文件名、文件内容、姓名、地址、账号、原始服务端错误或其他敏感信息。
结果事件不得因页面跳转或按钮点击提前上报；重复回调不得产生重复业务结果事件。

9. 原型与 Figma 页面清单

预览菜单新增 增信提额 分组：

首页：可提交、审批中、入口隐藏；
方式页：未选择、已添加多个、同项 7 天冷却；
方式页：后台动态新增项展示；
银行流水：待上传、已选文件、上传失败/超时、安全检查未通过、相同文件拦截；
同业竞品额度：已选文件；
钱包流水：已选文件；
水电单：待上传、已选文件；
风险审批中：首次提交后、离开后再次进入；
结果：提额成功、额度不变（含额度释放与还款引导）、资料需重传。

Figma：袋鼠金融-APP → KasyKredit 页面；每个页面/状态使用独立 750×1624 Frame。

参考原型

10. 验收标准

10.1 准入与入口

有至少一笔已结清借据、当前无在贷借据、账户正常且当前可申请借款的命中客群用户，可以看到并进入提额流程。
无结清记录、当前存在在贷借据、账户冻结/注销、当前不可申请借款或未命中入口客群的用户，看不到入口；直接访问 H5 页面也不能绕过资格确认。
审批中再次进入时恢复原申请，不展示资料选择，也不能创建第二笔申请。
审批终态不新增首页专属状态；结果在结果页展示，返回首页后按实时资格重新展示入口。

10.2 动态资料项

默认展示四类资料，编码分别为 bank_statement、other_lender_limit、wallet_statement、utility_bill。
新增通用单文件资料项后，无需 H5 发版即可按配置顺序展示；未知图标使用通用文件图标。
人工开关关闭或不在生效窗口内的资料项不能用于新申请；已提交申请仍按提交时名称和规则展示。
MVP 不按 cust_level 或其他标签差异化资料项，也不做个性化推荐。

10.3 上传与判重

PDF/JPG/PNG、单文件不超过当前配置上限时可以上传；空文件、格式或大小不符时给出明确提示且不产生冷却。
水电单可直接作为风险参考资料提交，不以 OCR 成功作为前置条件，页面不宣称已完成住址验证。
相同内容文件不能在当前申请中重复使用，修改文件名不能绕过；需重传时不能再次选择上次被退回的同一文件。
安全检查未通过时文件不进入申请，展示统一更换文件提示，不泄露安全检查细节，也不影响篮子中其他资料。
单文件上传超过 60 秒进入超时状态，保留文件名和其他已添加项，只能由用户手动重试，不产生冷却。

10.4 提交、冷却与审批

一次申请可以提交一个或多个不同资料项，每种类型最多一个；提交前可以替换。
冷却从最终提交成功开始，默认 7 个自然日；仅选择或上传文件不产生冷却。
resubmit_required 只解除被退回资料项的冷却；提额成功和额度不变保留冷却，其他资料类型仍可独立提交。
重复点击、刷新、弱网重试和重复审批结果不得生成重复申请或重复额度变更。
审批中离开页面后可以恢复，前端等待超时不能把审批中改成失败。

10.5 额度与结果

H5 只展示风险审批与额度生效结果，不自行计算或承诺提额。
新额度按总额度覆盖且不主动降低当前额度；不修改已有借据及账务。
额度尚未完成生效时保持审批中；只有生效成功后展示提额成功。
额度不变页面明确当前额度未降低、本次提额额度已释放，并展示良好还款引导；资料需重传页面明确可立即重传。

10.6 埋点与页面

首页、方式页、上传页、审批中页和结果页均按第 8 章定义产生唯一、稳定的曝光、点击或结果事件。
提交成功、风险结果和额度结果以可信业务状态为准，不以按钮点击或页面跳转代替。
埋点不包含文件名、文件内容、姓名、地址、账号、原始金额或原始错误文本。
H5 基准视口无横向滚动，主要操作与错误提示可见；Figma 每个页面/状态使用独立 750×1624 Frame。

袋鼠金融蓝图

探索

File History

现金贷增信提额 H5 需求文档

1. 背景与目标

2. MVP 范围

2.1 本期支持

2.2 本期不支持

3. 用户准入与入口配置

3.1 增信项后台配置

4. 页面信息架构与视觉引导

5. 页面交互流程

5.1 多资料提交

5.2 同项重复提交与 7 天冷却

5.3 上传与弱网

5.4 审批中再次进入

6. 业务状态

7. 额度变化规则

8. 埋点

9. 原型与 Figma 页面清单

10. 验收标准

10.1 准入与入口

10.2 动态资料项

10.3 上传与判重

10.4 提交、冷却与审批

10.5 额度与结果

10.6 埋点与页面

关系图谱

目录