还款生命周期

还款类型 REPAYMENT_TYPES 取值：IOURepay=提前还款、BillRepay=账单还款；还款方式 REPAYMENT_METHODS VA=VA。

还款状态 REPAYMENT_STATUSES 取值：P、S、C，标签为 in_process/success/failed。

交易类型 PS（POINT_SATISFACTION）表示质押积分代偿，标签为 Repayment，行标题为 MPC Points。

交易类型 DS（DEPOSIT_SATISFACTION）表示质押余额代偿，标签为 Repayment。

交易类型 P（REPAYMENT）表示还款。

退款/还款记录接口 coreTransQueryRefundRepayRecord 是独立接口，由账单模块使用，不属于主交易列表。

首页根据 daysToDue（0/1/2-3）展示对应的站内还款到期提醒文案。

账单页当到期日与今日之差 ≤ 3 天时，展示站内还款到期提醒文案。

首页到期分支按后端 daysToDue 判定：===0 展示 please_repay_by_today_to_avoid_the_late_fee；===1 展示 dont_forget_to_repay_within_day_by；2–3 展示 dont_forget_to_repay_within_days_by；否则展示 your_bill_is_ready_repay_by_etc。

账单页当 remainDays 为 2–3 天时展示文案 dont_forget_to_repay_within_n_days（带 n）。

账单页当 remainDays === 1 时展示文案 dont_forget_to_repay_within_one_days。

账单页当 remainDays === 0 时展示文案 please_repay_today_to_avoid_late_fee。

账单页当 remainDays > 3 时文案为空，不提醒。

账单页 isOverDue 为真时展示文案 your_bill_is_n_days_overdue_please_repay_now。

账单页 remainDays 定义为 dueDate 与当前日期的天数差 dayjs(dueDate).diff(currentDate,'days')。

还款/逾期提醒为纯站内文案加 banner/popup，阈值在前端按账单页的 remainDays（dueDate 差值）与后端下发的 daysToDue/overdueTimes（首页）判定。

minimumRepaymentMinAmount 为最低还款触发的最小应还门槛（单位为分）；仅当应还金额≥此值才允许走最低还款。

首页分期还款入口（isRepayInstallmentAllow）需 repayByInstallmentSwitch 为开与 flexCode 第1位=1 同时成立；账单页则与 marketCode 第15位=1 组合。

repayByInstallmentSwitch 控制分期还款入口的开关。

允许走最低还款（isMinimumRepayAllow）需同时成立：minimumRepaymentSwitch 为开、flexCode 第3位=1、非 Y001、已出账未逾期、应还金额≥门槛。

minimumRepaymentSwitch 是最低还款（最小还款）功能的总开关。

还款流转：处理中 P 转成功 S 或失败 C。

字段 HAS_REPAY 取值 Y/N（默认 N），表示是否有过还款。

还款类型 REPAYMENT_TYPES.BILL_REPAYMENT=BillRepay 表示按账单还款。

还款类型 REPAYMENT_TYPES.EARLY_REPAYMENT=IOURepay 表示单笔借据提前结清。

还款状态 REPAYMENT_STATUSES.FAIL=C 表示还款失败。

还款状态 REPAYMENT_STATUSES.SUCCESSFUL=S 表示还款成功。

还款状态 REPAYMENT_STATUSES.PENDING=P 表示还款交易处理中。

账单状态流转：未出账 U 出账后变已出账 N；按期还清则已还清 F；到期未还变已逾期 O（OVERDUE_DAYS>0），还清后变已还清 F。

综合账户态 ACCOUNT_STATE 取值为 W/AC/NAC/RFC/OPC/NU/HN/HF/HO。

账户层使用态 ACCT_USE_STATUS（USE_STATE_TYPE）取值：W 未使用、H 当期有已出账单、N 当期无已出账单。

账单布尔 isRepaid 由 STMT_STATUS===F 判定，表示已结清。

账单布尔 isUnused 由 CUR_STMT_AMT===0 且 STMT_PAID_AMT===0 判定，表示本期未使用。

账单布尔 isCanRepay 由 STMT_STATUS===N 或 ===O 判定，表示已出账（含逾期）可还款。

账单布尔 isNoBill 由 STMT_STATUS===U 判定，表示未出账。

账户级账单状态 acctStmtStatus=NONE（BILL_STATE_TYPE.NONE）表示无账单数据。

账单状态为「已还清」时 STMT_STATUS=F（STMT_STATUS_MAP.REPAID / BILL_STATE_TYPE.CLEAN_DUE），表示账单已结清。

账单状态为「已出账」时 STMT_STATUS=N（STMT_STATUS_MAP.HAD_BILL / BILL_STATE_TYPE.IN_DUE），表示账单已出、待还款。

账单状态为「未出账」时 STMT_STATUS=U（STMT_STATUS_MAP.NO_BILL / BILL_STATE_TYPE.NOT_IN_DUE），表示本期账单未出。

账单级状态为 STMT_STATUS_MAP；账户级 acctStmtStatus（=ACCT_STMT_STATUS）取值同为 BILL_STATE_TYPE（含 NONE）。

提前还款违约金口径不统一：取现为 10%，消费为 8%，是否有意为之需 PM 确认。

额外功能服务费可配固定值或本次借新还旧金额×X%；前端info弹窗该行被注释屏蔽，参与后台计算但不对客展示。

月最低还款本金占比配置位为Flex第5-6位。

月最低还款：指定期数本金占比默认10%（适用1期及3期借据，可配）；当期应还利息默认100%（可配0–100%），此利息含全部应收fee=admin fee+service fee。

月最低还款额=X%指定期数借据本金+其他期数借据当期应还本金+X%当期应还利息+额外功能服务费(如有)+逾期罚息(如有)。

Instant Cash取现提前还款违约金=提前还款金额的10%，与消费8%不同。

PayLater消费提前还款违约金=提前结清金额的8%。

提前还款违约金：PayLater消费=提前结清金额×8%；Instant Cash取现=提前结清金额×10%。

还款承诺结果 PROMISE_RESULT：ACTIVE_PLAN、UNACTIVE_PLAN、NO_PLAN

还款计划动作 REPAYMENT_PLAN_ACTIONS：EARLY=L

还款状态 REPAYMENT_STATUSES：PENDING=P、SUCCESSFUL=S、FAIL=C

还款方式 REPAYMENT_METHODS：VA 表示虚拟账户

还款类型 REPAYMENT_TYPES：EARLY_REPAYMENT=IOURepay（提前还款）、BILL_REPAYMENT=BillRepay（账单还款）

交易类型 POINT_SATISFACTION=PS，语义为质押积分代偿

交易类型 DEPOSIT_SATISFACTION=DS，语义为质押余额代偿

交易类型 REPAYMENT=P，语义为还款

BIZ_SCENE 取值 MULTI_SETTLE 表示多笔结清（调整还款计划，非逾期直入分支）

BIZ_SCENE 取值 MINI_REPAY 表示最低还款

当 HAS_REPAY 为 Y（已还过）时，禁用最低还款入口。

当账单状态 STMT_STATUS 等于 'F' 时，判定为已结清（isRepaid）。

当本期账单金额 CUR_STMT_AMT 为 0 且已还金额 STMT_PAID_AMT 为 0 时，判定账单未使用（isUnused）。

当账单状态 STMT_STATUS 为 N 或 O 时，判定为已出账可还款（isCanRepay）。

当账单状态 STMT_STATUS 等于 'U' 时，判定为未出账（isNoBill）。

账单状态枚举 STMT_STATUS：REPAID，值 F，语义为已还款/已结清。

账单状态枚举 STMT_STATUS：OVERDUE，值 O，语义为已逾期。

账单状态枚举 STMT_STATUS：HAD_BILL，值 N，语义为已出账。

账单状态枚举 STMT_STATUS：NO_BILL，值 U，语义为未出账。

currentState（后端 CURR_STMT_STATUS）表示当前业务日期前一账期账单状态，有账单时有值。

acctStmtStatus（后端 ACCT_STMT_STATUS，缺省 NONE）为账户账单状态，取值 U=未出账、N=已出账、F=已还清、O=已逾期。

unbillAmt（后端 UN_BILL_AMT）为未出账账单总金额，实际计算逻辑是「下个未出」。

BIZ_SCENE 是试算场景码：MINI_REPAY(月最低还款借新还旧)、JXHJ(账单分期)

月最低还款指本月只还最小额（本金+利息），剩余转下月起新借据，免服务费，由 flexCode 第3位门控

flexCode 为 50 位定长位段，用于灵活还款门控：账单分期(1)、月最低还款(3)、逾期可用(18)、在贷重组(19)、借新还旧期数/费用(20-31)、头息(17)

Flex code第3位为月最低还款可用性：0=不可用，1=可用。

若杠杆率或杠杆额度上限提升则触发push通知

本次还款提额额度不依赖还款接口直接返回，而是查询提额记录，读取本次还款成功当日对应类型最后一条记录（还款任务提额类型PayLaterRepayment+风险提额类型ActiveRepayment）

剩余可领取杠杆额度>0才展示并提供top up跳转质押页，为0则隐藏奖励与top up按钮

还款成功后持续轮询15秒（每2秒查询1次）杠杆率奖励是否发放；超过15秒未查到则展示当前已有奖励内容，15秒内查到则按结果展示（只展示本次还款后有提升的奖励内容）

还款段对外上报仅入口级（VIEW_BILLING_CYCLE_PAGE 及 REPAY 点击类），还款成功无对外上报、全链路无 GPS 上报

提前结清金额锁死不可改，提交时整包随 LOAN_LIST 上送

提前结清构成由 coreTransQueryPayOffInfo 返回，含本金、利息、罚息、违约金、月费五项

还款轮询以 REPAY_STATUS='S' 且 MARKET_CODE_HANDLE_STATUS='END'（调额引擎处理完）为成功终态，PENDING 继续轮询

基础还款页 Y001 有还款成功奖励链，常规还款页无

常规还款页最低还款成功页为 COMMON_RESULT_BILL_REPAY，含五态 status 1/2/3/5/6

常规还款页轮询同接口但 Loading 30s，最低还款走 coreTransRepayInstallmentResult，2s×6

基础还款页结果轮询调用 coreTransQueryRepayResult，2s×8，Loading 15s

常规还款页全额提交同基础页但不带 LOAN_LIST，最低还款走 coreTransMinimumRepayApply

基础还款页提交调用 coreTransApplyRepay，参数含 TXN_CODE(BillRepay/IOURepay)、REPAY_TYPE='VA'、TOT_AMOUNT、session，LOAN_LIST 仅结清时携带

基础还款页验证走 PIN（scene=OTHER），IM3/BIMA 客群走 IOH OTP（category=REPAYMENT）；常规还款页验证走 PIN

常规还款页当输入金额≥最低还款额且≠全额时首次弹出「Try minimum」弹窗

基础还款页金额校验允许部分还款，仅校验金额≤应还且≤钱包余额两条

基础还款页面向 Y001 与提前结清场景，常规还款页面向非 Y001 的账单还款

两个还款页分流：isY001 或提前结清走基础页；否则走常规页。

各类还款都需接合同（RIPLAY）iframe 并做密码验证（COMMON_PASSWORD_VERIFY）。

账单分期能力门控：repayByInstallmentSwitch='Y' 且 flexCode 第 1 位命中。

最小还款能力门控：flexCode[2]==='1' 且 minimumRepaymentSwitch='Y' 且满足金额门槛。

借新还旧通过 coreTransTryLoan 发起，业务场景 BIZ_SCENE=MINI_REPAY、LOAN_CODE=9022。

点击最小还款入口后，经 preselectMinimum 三段链路进入常规还款页并自动预选最小还款。

最小还款功能可用的条件之一：应还金额须大于等于最小还款门槛 minimumRepaymentMinAmount。

最小还款功能可用的条件之一：后台开关 minimumRepaymentSwitch 开启。