LOCAL 代收全流程
所属：Paisa 运营人员指南 · 第 4 篇
上一篇：三端账户余额怎么变 · 下一篇：LOCAL 代付全流程
商户发起 代收（用户向平台/商户付款）且路由到 LOCAL 通道时，流程从 第 1 篇选卡 开始，到成交或关单结束。资金变动见 第 3 篇。
1. 流程总览
2. 创单与派卡（第 1 篇）
- 路由选中 LOCAL 通道。
- 按 第 1 篇 选卡：过滤规则 → 加权抽签 → 同金额占位 → 冻结App用户余额。
- 生成 UPI 收款码 与 H5 收银台链接，创建子单为 支付中，主单 待处理。
- 若无任何「认证免检期内」可派卡，LOCAL 创单失败，订单尝试 下一支付通道。
3. 付款人侧
- 付款人在收银台扫码，向派单卡的 UPI 付款。
- 提交银行流水号（UTR）：子单 → 审核中，主单 → 进行中；系统异步拉账单匹配（见 第 6 篇）。流水号与账单一致时 精准匹配优先于时间窗，迟到几分钟入账也可确认；若填错，不会直接失败，继续按金额+时间窗兜底，命中后以账单真实流水号覆盖误填值。
- 流水号查账暂未匹配：创单未满 10 分钟时 不立即关主单（账单常有延迟到账），保持审核中并继续查账；满 10 分钟后做最后一查：
- 已成功拉到账单但仍对不上（HIS 耗尽） → 硬关子单（支付超时）、解冻加回（不自动通知商户取消）；
- 未拉到账单（钱包掉线、上游异常等，时窗内无成功爬虫） → 主单 软失败（取消，子单与App用户冻结保持，不自动通知商户取消），后续真实对账成功可 复活；若之后出现 HIS 成功未匹配，或满 48 小时仍未成功，再硬关收敛并加回余额。 若因掉线、派单 UPI 变更、查账队列积压等长期挂在审核中且始终没有 HIS 耗尽证据，创单满 48 小时仍未成功时系统会 再查一次后强制关单 并加回余额。
- 未提交流水号：依赖定时自动查账（见下节）。
- 从钱包返回收银台：约 5 秒后再触发一次查账，避免账单尚未入库。
- 用户确认支付失败：仍可按取消关单，App用户余额加回（不自动通知商户取消）（第 3 篇）。
- 收银台倒计时（约 8 分钟）到期 / 客户端标记超时：仅影响展示，不再硬关单解冻；真正超时软失败以创单满 10 分钟为准。
- App用户取消 LOCAL 代收：主单取消、余额加回（不自动通知商户取消）。
4. 无流水号时的自动查账（印度时间）
| 时点 | 动作 |
|---|---|
| 创单后约 3 分钟 | 自动查账；未匹配不立即关单 |
| 创单满 10 分钟（未提/已提 UTR 均可） | 软失败前 最后一查：已拉账仍对不上 → 硬关并解冻；未拉到账（掉线等）→ 主单软失败（子单与冻结保持） |
| 软失败后再次出现 HIS 成功未匹配 | 视为 HIS 耗尽，立即收敛子单并解冻（不必等 48 小时） |
| 创单满 48 小时仍未成功 | 关单前 再查一次；无论是否拉到账单，未确认成功则 强制关单并解冻（覆盖已交 UTR、掉线 hold、派单 UPI 变更 hold、以及此前软失败未收敛等）；不自动通知商户取消 |
| 软失败后 | 后续对上账可 主单复活成功；LOCAL 也可继续后台查账补单（见 第 7 篇） |
| 主单已取消结束、子单却仍挂进行中（历史遗留/异常路径） | 系统每分钟扫描；创单且最近一次更新均超过 30 分钟、确认没有补单/查账正在处理后，把子单补成 支付超时 终态。若余额此前未加回则先锁定解冻资格再 补加回，已加回则只补状态、不重复加钱；冻结信息异常时停止自动处理并告警。避免这类订单长期占用该卡的接单名额导致 接不到新单 |
收银台 H5 倒计时仍按约 8 分钟展示；系统超时阈值为 10 分钟。软失败仅针对「时窗内无成功爬虫」；HIS 耗尽应立即硬关。48 小时为最长占用绝对兜底。
5. 成功路径
- 爬虫账单与订单匹配成功（规则见 第 6 篇）。
- 子单 → 成功；主单 → 成功。
- 进行中订单的冻结登记直接 → 已消费；商户余额增加并通知商户。
- App侧写 Sell 流水；补单若需分批实扣，则每个批次各写一条。
5.1 补单成功与分批待扣
主单已取消、登记为 已解冻 后若补单复活成功：
- 系统按余额执行首批实扣：余额足以清尾时一次扣清，否则只扣可用整百卢比；
- 未扣部分记为
remaining，用户余额保持非负且直接展示真实account.balance； - 用户加款后按 FIFO 继续实扣，每批写 Sell 明细；remaining 清零后封账为 解冻后消费；
- remaining 未清时暂停该用户 LOCAL 新派单，App 显示黄色 Success，清零后转绿色。
进行中订单（登记仍为 冻结中）直接成功时一律 0→已消费，派单阶段已扣余额，成功时不再二次扣款，也不进入待扣。
商户回调：补单接口返回成功且主单已是 成功 时，系统会再向商户 同步补发一次成功回调（含幂等补单：订单本来已成功再次调用补单）。外部通道仅下游补单受理、本地主单尚未成功时，不会在此步补发。
6. 失败与特殊路径
| 情况 | 子单/主单 | App用户余额 |
|---|---|---|
| 10 分钟最后一查：HIS 耗尽（已拉账未匹配） | 子单支付超时；主单取消 | 加回 |
| 10 分钟最后一查：未拉到账（掉线等）→ 软失败 | 主单取消（等待结果）；子单不变 | 不加回（冻结保持） |
| 软失败后真实成功 | 主单复活成功；子单成功 | 按成功路径消费冻结 |
| 软失败后再次 HIS 成功未匹配 / 硬关 / 真实失败 | 子单支付超时或取消；主单保持取消 | 加回 |
| 用户/商户主动取消 | 子单取消；主单取消 | 加回 |
| 创单满 48 小时强制关单 | 子单支付超时；主单取消 | 加回 |
| 提交流水号后仍对不上（用户提交/补单来源） | 较快关单 | 加回 |
| 钱包掉线（登录失效），未满 10 分钟 | 子单保持支付中或审核中；卡标未认证 | 不加回，等 OTP |
| 上游暂时繁忙，拉账失败 | 保持当前状态，入自动重试 | 不加回 |
| 支付超时且 卡未认证 | 子单转 审核中，打「等重认证」标记；主单可不关 | 不加回 |
| 关单后重试仍对不上 | 子单由审核中收尾为取消；主单保持取消 | 关单时已加回 |
| 关单后重试对上 | 补单复活 → 成功 | 见 第 3 篇 补单扣款 |
| 关单后 HIS 已耗尽（曾成功拉账但仍对不上，且查账时刻已晚于关单+1 分钟） | 商户 补单 / 后台重试 仅查 账单总表，不再调实时爬虫；总表有记录 → 成功，无记录 → 失败 | — |
7. App用户余额何时加回（客服速查）
完整资金口径见 第 3 篇 · 2.6～2.7。代收侧记住三句话即可：
- 没关单就不加回：支付中、审核中、掉线、繁忙、等 OTP、以及 主单软失败但子单未收敛 时，钱仍被本单占用。
- 硬关/真实失败才加回：满 10 分钟 HIS 耗尽硬关、满 48 小时强制关单、用户/商户主动取消、认定查账失败、软失败后的硬关收敛——登记改为已解冻，余额加回。仅主单软失败（尚无 HIS 耗尽证据）不加回。
- 关单后还能复活：硬关加回之后若后台又对上了账，补单成功会再扣一笔（见第 3 篇补单路径）；软失败未解冻时对上账则主单直接复活成功。
8. App端 可见范围（Sell 代收列表）
App用户在 App Sell（代收） 订单页看到的记录，与后台/爬虫实际处理状态不完全一致：
| 场景 | App端 是否可见 | 展示状态 |
|---|---|---|
| 代收冻结中，主单未关单（仍在支付/审核/等 OTP 等） | 可见（Sell → In Progress） | Pending |
| 代收冻结中，主单已关单（关单后仍在查账/补单路径） | 可见（Sell → In Progress） | Checking（可手动 Send Reminder 触发查账） |
| 成功，扣款已完成 | 可见（All / Archived 两个 Tab 均展示） | 绿色 Success |
| 成功，补单 remaining 未清 | 可见（All / Archived 两个 Tab 均展示） | 黄色 Success；详情展示分批扣款时间线 |
| 取消、支付超时、各类失败（冻结已解冻） | 不可见 | — |
首页余额旁会展示当前 Selling 冻结金额（与 In Progress 列表同源），点击可直达 Sell → In Progress。
客服说明要点：
- In Progress 只展示当前仍占用App用户余额（代收冻结登记为冻结中）的订单；Pending 表示主单尚未关单，Checking 表示主单已关单但冻结仍在、系统仍在查账。
- Sell → All / Archived 展示业务已成功的代收单；黄色 Success 表示商户侧已成功、App侧仍有 remaining，并非订单失败。
- 若用户问「钱被扣了但列表里没有单」，先确认是否在首页 Selling 金额或 In Progress；若 Selling 为 0，引导查看 第 3 篇 · 2.6 冻结口径。
9. 与爬虫、异常的关系
下一篇 → 第 5 篇：LOCAL 代付全流程