转分期与重组

转分期提交时（80530300）期数不可修改。

当 overdueTimes>1 时展示 Adjust CTA。

逾期重组受 DPD 窗口 [30,90] 门控（config 驱动）。

逾期重组首页入口在日终维护窗口 23:30–24:00 期间被拦截。

展期（EX）的唯一实际请求点为展期列表页，硬编码 TRANSACTION_TYPE:'EX' 拉取展期记录；主交易列表不渲染 EX 标签。

交易类型 EX（EXTENSION）表示展期，无 TYPE_MAP 项，主列表标签为空，仅由展期列表查询使用。

根据 negotiateRepaymentPlan.promiseResult 触发站内新还款计划弹窗（NewRepaymentPlanPopup）。

当账单处于逾期（overdue）且可改造时，站内展示逾期改造 banner。

首页逾期改造 banner showOverdueRestructureBanner 展示时显示文案 adjust_repay_overdue_desc 与 CTA adjust。

restructureMaintenanceStartTime/EndTime 定义逾期重组首页入口的日终维护窗口边界（HHmm 字符串，[start,end) 服务端时间，不支持跨午夜）；窗口内点击入口弹维护弹窗不进流程，推成 start≥end 即永不命中。

逾期重组入口在 DPD 缺失时，因 NaN 判定采取 fail-closed，隐藏入口。

restructureOverdueMinDpd/restructureOverdueMaxDpd 定义逾期重组入口的 DPD 窗口上下界，账户逾期天数须落在 [min,max] 双闭区间才展示逾期重组入口/预付；仅 gate 逾期分支。

loanRestructuringOverdueSwitch 控制逾期场景是否允许贷款重组：当取值为 'N' 时在逾期状态下屏蔽重组入口。

贷款重组入口展示需 loanRestructuringSwitch==='Y' 且 flexCode 第19位（charAt(18)）∈{1,2} 同时成立。

loanRestructuringSwitch 控制贷款重组（结构化分期）入口的开关。

逾期流转：账单逾期后可申请展期重组（处理中 P 转成功 S 或失败 C），还清后逾期解除。

展期重组申请通过 API /core/trans/extension/apply 发起，交易类型为 EXTENSION=EX。

展期重组状态 extensionStatus.C=failed 表示展期/重组申请失败。

展期重组状态 extensionStatus.P=inprocess 表示展期/重组申请处理中。

展期重组状态 extensionStatus.S=success 表示展期/重组申请成功。

期数相关位段：Flex 第 13-14 位为新借据最大期数、15-16 位为最小期数、24-25/26-27 位为借新还旧可选最小/最大期数。

逾期重组门控条件：Flex 第 19 位 ∈{1,2}，且 loanRestructuringSwitch=Y，逾期场景叠加 loanRestructuringOverdueSwitch carve-out。

逾期重组发起时 BIZ_SCENE=OVERDUE_RESTRUCTURE，AMOUNT=accountPrinAmt。

逾期入口重组将多笔合并成一笔更长期限新贷，免 admin fee 与罚息（feeWaivedAmt）。

逾期重组每期应还 = 重组后应还总额 ÷ 选择期数。

逾期重组后应还总额 = 剩余未还本金×(1−本金减免比例) + 剩余未还利息及罚息×(1−利息及罚息减免比例)。

调整还款计划（多笔重组）使用 BIZ_SCENE=MULTI_SETTLE，走非逾期直入分支。

转分期/展期的费项构成与新借据相同（admin fee 月费率 + 头息），现网展期费率以引擎下发为准。

转分期与借据展期入口底层为同一 EXTENSION 能力，标识为 TXN_CODE=EXTENSION、TRANSACTION_TYPE='EX'。

账单分期门控条件：repayByInstallmentSwitch=Y且Flex第1位开启。

账单分期一期功能：本月全额结清当期账单+生成新借据按期还（最长期限）。

借新还旧借据：新借据默认1期（可配N期），为取现借据；其头息率=Flex第17位（0–9→0%–9%），replan费=Flex第11-12位。

replan/重整费率按新借据本金×replan费率计，适用月最低还款、转分期/重组的新借据；配置位Flex第11-12位（00=无费/01=1%/…/99=99%）。

展期状态 extensionStatus：S=success、P=inprocess、C=failed

交易类型 EXTENSION=EX，语义为展期

BIZ_SCENE 取值 OVERDUE_RESTRUCTURE 表示逾期重组（逾期直入分支，AMOUNT=accountPrinAmt）

BIZ_SCENE 取值 JXHJ 表示转分期，调 tryLoan 时配 TXN_CODE=AUTH_LOAN_CASH、LOAN_CODE=9022

currentServerTime 由 ifes-ams getCommonPage 下发服务端时间（DD/MM/YYYY HH:mm:ss），前端据此算时钟偏移 serverTimeOffsetMs，供逾期重组维护窗口判定。

逾期重组预付引导页 New repayment plan 示例默认展示最长期（月供最低），格式为 RpY x Nmonths，由 coreTransTryLoan 返回的 LOAN_LIST 派生。

restructurePrepay 前端 query 参数用于标记还款页进入逾期重组预付路径；仅在该路径下定制 Repay first、First repayment、Amount to repay、Repay 文案与底部安全间距，对普通还款无影响。

accountPrinAmt（后端 ACCOUNT_PRIN_AMT）为账户在贷本金，逾期重组直入时作为还款 AMOUNT。

转分期 / Convert / 展期 / Extension 指把已有借据摊更多期（收费），底层 TXN_CODE=EXTENSION / TRANSACTION_TYPE='EX'，准入条件为 riskCode 含 ZQ01

逾期重组 / Adjust Repayment 指把多笔借据合并成更长期新贷、降月供，名单由风险上传，由 flexCode 第19位门控

账单分期指本月全额结清当期并同时生成新借据按期还，由 flexCode 第1位加 repayByInstallmentSwitch 门控，BIZ_SCENE=JXHJ

风险标签 ZQ01（ConvertInstallmentUser）表示借据展期用户，底层走 EXTENSION，产品侧转分期即此

标签 ZQ01（常量名 ConvertInstallmentUser）表示借据展期用户，底层走 EXTENSION 展期，产品侧"转分期"即此

Flex code第29位控制借新还旧新借据是否允许再次重组：0=不允许（默认），1=允许。

Flex code第19位为在贷借据重组功能状态：0=不可见，1=可见且可用，2=可见但不可用（入口可见、点击后显示不可用）。

Flex code第1位为账单分期可用性：0=不可用，1=可用。

解押时验 PIN 成功后取消质押增加的额度，并抹除流动性定价 ID（若享价格权益）。

可解押条件为当前剩余可用额度大于等于本笔质押增加的额度，满足时解押按钮高亮，否则置灰并提示需先还款。

Flex code为50位，位段含义：账单分期(1)/月最低还款(3)/逾期可用(18)/在贷重组(19)/借新还旧期数与费用参数(20-31)

逾期重组是在逾期/有压力场景把多笔借据合并成一笔更长期新贷、降月供，逾期入口免息免罚，准入为flexCode第19位∈{1,2}且loanRestructuringSwitch=Y。

账单分期在还款时选择分期还，本质是本月全额结清当期并同时生成新借据按期还（本月不还、下月起），准入为repayByInstallmentSwitch=Y。

转分期用户旅程：可转借据列表→选某笔借据→看当前每期与新每期对照（默认预选最长期）→确认页费用摊开（总管理费/每月管理费/服务费）→PIN（IM3/BIMA走OTP）→结果三态，失败可Try Again。

转分期结果由extensionStatus映射为三态：success、inprocess、failed。

返回码80530300表示该借据期数不可改。

可转列表前端不叠加过滤，后端返回的借据即为可转。

转分期在底层走TXN_CODE=EXTENSION，并以TRANSACTION_TYPE='EX'拉取可转借据。

选期数页的可选期数由后台coreTransTryLoan返回的LOAN_LIST动态驱动，非前端写死，页面默认预选最大一期。

转分期的准入条件为riskCode包含ZQ01。

当某笔借据期数不可改时（后端返回80530300），用户被提示后退回可转列表。

转分期只对被风险标签ZQ01（借据展期资格）圈选的用户可见，并非所有人可见。

转分期与账单分期、逾期重组是三个不同的能力。

转分期是指用户把一笔已有借据/欠款主动摊成更多期偿还，以降低单期还款压力，并收取费用。

逾期重组由风险上传名单+方案，用户确认后不可变更

协商方案生效后每月还款复用普通 BillRepay，方案详情页 Repay 按钮带下期金额进还款页

接受协商方案调 negotiateRepaymentPlanConfirm，减免维度为本金/费用/罚息三个比例

借新还旧方案状态三值 promiseResult：NO_PLAN 无、UNACTIVE_PLAN 未生效（首页入口卡→弹窗选方案）、ACTIVE_PLAN 已生效（→方案详情页）

预付状态四值 PENDING/VERIFYING/PAID/EXPIRED，VERIFYING 状态轮询 5s×12

预付回流闭环流程：needRestructurePrepay 满足（开关+prepayRequired='Y'+状态≠PAID）→ PrepayIntro → 预付还款走常规还款页(restructurePrepay='1')→ 成功调 restructurePrepaySettle 核销 → 成功页续到 NewLoan?source=overdue

逾期重组结果页四态：成功（含重组前后账单对比）、处理中、失败（Try Again 逾期回 NewLoan、多选回选择页）、one-more-step（新贷已放款但还款失败，引导去还款）

MULTI_SETTLE 提交调 coreTransRepayInstallmentApply(200029)带 ORIG_STMT_BAL_AMT+逐笔 LOAN_LIST；OVERDUE_RESTRUCTURE 提交调专用 coreTransOverdueRestructuringApply(200037)且 LOAN_LIST=null

MULTI_SETTLE 新贷金额为选中借据本金合计；OVERDUE_RESTRUCTURE 新贷金额为残余本金 acctPrinPaidOut

逾期重组多借据选择至少选 2 笔、至多 10 笔，超限 toast 提示

逾期重组多借据选择页调 coreTransLoanRestructuringList(QUERY_LOAN_STATUS='UN_PAID_OUT') 拉列表，按 eligibleForRestructure='Y' 分可选/不可选

分期结果态 FLOW_STATUS：PROC_SUCC 成功、WAIT 处理中、CASH_FAIL 放款失败、REPAY_FAIL 还款失败（放款成功还款失败为 one more step 部分态）

账单分期与月最低还款共用 coreTransRepayInstallmentResult 轮询，CODE=80530014 继续轮询、80530015 为在途态

账单分期提交调 coreTransRepayInstallmentApply（独立 Confirm 页+RIPLAY+TnC）；月最低还款提交调 coreTransMinimumRepayApply（常规页内联，额外带 MINI_REPAY_AMT）

账单分期试算 BIZ_SCENE='JXHJ' 且 AMOUNT=账单额；月最低还款试算 BIZ_SCENE='MINI_REPAY' 且 AMOUNT='0'（额度由后端算）

loanRestructuringOverdueSwitch=N 时即便 Flex 位段命中也禁用逾期入口；它是叠加的 carve-out，不取代位段读取。

逾期 carve-out：逾期场景在读 Flex 第 19 位 + loanRestructuringSwitch 之上额外叠加 loanRestructuringOverdueSwitch，isAdjustRepayAllow 先判断 isOverDue && loanRestructuringOverdueSwitch==='N' 时返回 false，再读位段。

逾期重组能力门控：flexCode.charAt(18)∈{'1','2'} 且 loanRestructuringSwitch='Y' 且满足逾期 carve-out 且 DPD∈[30,90]（仅逾期分支）；首页入口另受维护窗口 23:30–24:00 拦截。

展期入口与 06 转分期底层是同一个 EXTENSION（展期）能力，走 TXN_CODE=EXTENSION / TRANSACTION_TYPE='EX'，两个入口复用同一笔后台交易。

白名单用户当期账单金额=0 或账单已还清、且下一个未出账单金额>0 时，模块展示下个未出账账单金额并新增展期入口，点击进入现有展期流程；其他账单状态按原有展示。

预付门槛判定来源改为专用 AMS 预付状态接口 restructurePrepayStatus；命中条件为 restructurePrepaySwitch='Y' 且 prepayRequired='Y' 且 prepayStatus≠'PAID'（PENDING/VERIFYING 均拦）；开关关或接口缺失则不设门槛直接放行。

修正后：重组失败 Try Again 路由对逾期直入用户回 NewLoan?source=overdue（与入口一致），不再一律回多借据选择页。

修正后：逾期直入重组的提交本金 LOAN_INIT_PRIN 改取精确剩余本金 ACCT_PRIN_PAID_OUT，与展示金额、试算入参三者对齐；MULTI_SETTLE 分支不变。

修正后：PrepayIntro「Remaining total amount」展示剩余应还总额 ACCT_SUM_PAID_OUT（本金+利息+罚息+费用），试算 AMOUNT 不变仍用剩余本金。

修正后：账单页 SIKLUS TAGIHAN 与 DETAIL TAGIHAN 的 Adjust CTA 与首页同款走 needRestructurePrepay → PrepayIntro，不再绕过预付步骤。

修正后：逾期重组 banner 提到 overdueTimes 计数分支之上，overdueTimes>1 的多次逾期用户也正常展示 Adjust CTA。

维护窗口边界行为：23:29:59 放行、23:30:00 拦截、23:59:59 拦截、00:00:00 放行。

回滚方式：后台把维护窗口配成 start ≥ end（如都 '0000'）即永不命中，免发版。

维护窗口拦截仅作用于首页两个逾期重组入口（逾期 banner 的 Adjust CTA 与 Adjust Repayment Plan 菜单格）；非逾期 Adjust 流程与账单页入口不在范围内。

维护窗口内点击逾期重组入口弹底部弹窗（标题 The function is not available / Menu tidak tersedia，按钮 Got it），不发生任何跳转；窗口外正常路由至 new-loan?source=overdue。

服务端时间来源：app 启动时从 ifes-ams getCommonPage 下发的 currentServerTime 算一次时钟偏移；字段缺失或不可解析时偏移=0，退化为设备时间（fail-open），后端交易层仍在窗口内硬拦截。

日终维护拦截窗口为服务端时间 [23:30, 24:00)，含头不含尾、不支持跨午夜；边界可由后台 restructureMaintenanceStartTime/EndTime 免发版调整，前端默认 '2330'/'2400'。

核心系统日终批处理窗口内逾期重组交易必失败，因此前端在入口处进行拦截。

OVERDUE_DAYS 缺失时按 fail-closed 处理：两个比较均不成立，逾期重组入口隐藏。

逾期重组入口的窗口/门槛判断只对逾期分支生效；非逾期的转分期路径不受影响，isOverDue=false 时窗口判断恒过。