业务规则 — 非常规摊还
本页汇总了管辖非常规摊还的创建、清算与取消的各项不变量。当端点页面引用某个错误码、字段或需要额外上下文的条件时,请查阅本页。
参考日期(reference_date)
reference_date 由调用方在创建请求中提供,是本服务使用的唯一时间基准 — 系统从不使用 date.today()。所有依赖日期的逻辑(逾期分期的分类、现值的按比例折现、early_amortization 可选分期的筛选)均以该字段为起点。
摊还类型
支持的 5 种类型,以及每种类型与创建模式的组合方式:
| 类型 | 模式 | installment_list | 分配规则 | 是否允许部分支付 |
|---|---|---|---|---|
equal_amount | 模式 2(Acquittance) | 不发送 | 按比例分配,先逾期后未来 | 否 |
first_installments | 模式 2(Acquittance) | 不发送 | 依次应用于前 N 期分期 | 否 |
present_amount | 模式 1(Targeted) | 发送 | 按分期显式指定;折扣顺序为利息 → 罚金 → 本金 | 否 |
matured_installments | 模式 1(Targeted) | 发送 | 仅限已到期的分期 | 否 |
early_amortization | 模式 1(Targeted) | 发送(恰好 1 期) | 单笔未来分期,支持部分支付 | 是 |
模式 1 — Targeted(带 installment_list — 整数 installment_number 数组):使用逐期 PV 端点 — 每选中一期调用一次。服务会将每个 installment_number 解析为 security 中对应的分期。模式 2 — Acquittance(不带 installment_list):使用批量 PV 端点 — 单次调用即返回所有分期的 PV。
提前摊还(early_amortization)
early_amortization 是唯一允许部分支付的类型。以下所有条件均适用:
installment_list中恰好 1 期分期 — 否则返回EVC100015。- 目标分期不得已逾期 — 否则返回
EVC100016。 amount必须小于等于该分期的现值 — 否则返回EVC100017。- 允许部分支付。
paid_amount > 0 AND paid_amount < expected_amount这一状态是从相关列派生出来的;并没有新增状态枚举值。pending_conciliation同时表示"未支付"和"部分支付";只有当total_paid_amount >= total_expected_amount - tolerance_amount时才会转为paid。
清算流程
内部编排。 非常规事件的清算在检测到付款时由 QI Tech(account-liquidation-api)执行 — 集成方在此环节无需调用任何端点,也不会收到专门针对状态转换的 webhook。以下规则描述的是内部行为,便于你理解创建之后发生了什么。
常规清算发出完整总额(规则 4)。 在 due_date 进行的常规清算仍会通过 SQS 发出该分期完整的 total_amount;不会扣减 paid_amount。该事件会在其自身的 early_amortization 引擎中对账部分已付状态。
取消与终结
内部编排。 取消与终结由每日例行任务触发 — 集成方无需调用任何端点来取消或终结一笔非常规摊还,也不存在面向租户的专用 webhook。以下描述仅供参考。