异常、重试与重认证
爬虫或账单匹配不顺利时，系统不会一律立刻关单。本篇按 钱包掉线、上游繁忙、查到了但对不上、重认证 四类说明。
1. 总览决策（无技术错误码）
2. 钱包掉线 / 卡未认证
| 表现 | 系统行为 | 代收App用户余额 |
|---|---|---|
| 爬虫提示 登录失效 或卡 未认证 | 关单前不因掉线立刻关单（代收支付中 / 审核中）；关单后复活遇 1004 仍收敛子单 cancel（余额已在关单时处理） | 关单前不加回；关单后复活不再动余额 |
| 代收 审核中 订单 | 打 等重认证补救 标记 | 不加回 |
| 代收 未满 8 分钟 就掉线 | 子单保持原状态；通知用户 OTP | 不加回 |
| 代收 满 8 分钟 要关单，卡未认证且 一条账单都拉不到 | 子单转 审核中 + 标记；主单按软失败取消（商户侧收尾，子单与冻结不动） | 不加回，继续占用直至成交或最终关单 |
| 代收 满 8 分钟 要关单，卡虽显示未认证但 本轮仍拉到账单且对不上 | 正常硬关（子单支付超时，主单取消），同时清除「等重认证」标记 | 加回 |
| 代收 满 8 分钟 要关单，且卡已认证 | 正常关单（子单支付超时，主单取消） | 加回 |
| 代付 支付中 超时 | 仍按原逻辑 支付超时（代付不等卡认证） | 代付不动App用户余额（见 第 3 篇） |
| 代付 审核中 且卡掉线/未认证 | 打 等重认证补救 标记；一直拉不到账单时最长约 48 小时自动彻底拒绝 | 代付不动App用户余额 |
| 用户完成 OTP / 重绑卡 | 见第 3、5 节 | 对上则成交；已拉到账单仍对不上则按未掉线正常失败处理（不再因补救标记长期 hold） |
运营口径：掉线 = 「暂时查不了账」，不是「订单失败」。在重认证或其它兜底之前，App侧 不要 按关单解释余额变动。资金细节见 第 3 篇 · 2.7。
但要注意：卡被标为掉线/未认证，并不代表账单一定查不到。有些卡掉线后账单入口仍然可用，系统照样能拉到完整账单。判断能不能判失败、能不能加回，只看 这一轮有没有真的拉到账单：拉到了且没有这笔进账，就按正常失败收敛；真的一条都没拉到，才继续等 OTP。
与 第 1 篇「认证免检期」关系：掉线后最多滞后约 一个扫描周期（约 20 分钟） 才会从派单池剔除。
3. 上游暂时繁忙
| 表现 | 系统行为 | 代收App用户余额 |
|---|---|---|
| 爬虫 暂时不可用（容量、超时等） | 子单保持 支付中 或 审核中 | 不加回，等同掉线前的「继续等」 |
| 自动重试 | 约 每 2 分钟 扫描队列；前 6 次间隔 5→30 分钟 线性递增，第 7 次起 60 分钟 封顶；默认最多约 24 次 | 重试期间仍占用 |
| 代收主单已 取消 后重试 | 仍可对账；对不上 则只把子单从审核中收尾为取消，避免「主单已关、子单仍审」 | 关单时已加回，重试不再动余额 |
| 代收主单仍进行中 | 继续等 8 分钟关单、用户提交、重认证等其它兜底 | 未关单前仍占用 |
3.1 代付截图 OCR 兜底重试
| 项目 | 说明 |
|---|---|
| 何时入队 | 用户已上传 支付截图，OCR 校验 金额/时间/收款方末四位 与订单一致，但爬虫 即将判失败（常见于钱包账单入账延迟） |
| 扫描频率 | 约 每分钟 |
| 重试间隔 | 第 1 次 5 分钟、第 2 次 10 分钟、第 3 次 20 分钟、第 4～12 次 30 分钟 |
| 次数上限 | 12 次（用尽后仍保持审核中，等 72 小时兜底） |
| 最终兜底 | 72 小时 仍未匹配 → 自动彻底拒绝 |
| 运营操作 | 审核页可手动通过/拒绝；也可点「爬虫重试」加速对账 |
3.2 同一张卡连续查不到账单 → 转按掉线处理
有一类情况用户会坚称「钱包能正常打开、也能收款」，但平台就是查不到这张卡的账单：钱包的账单查询入口只对这个账号不通（目前主要见于 Freecharge）。表现有两种，运营都只需理解为「这张卡查不了账」：
| 表现 | 说明 |
|---|---|
| 账单入口 直接拒绝 | 同一时刻别的账号能查到，换出口线路重试也无效 |
| 账单入口 返回空白 | 不报错，但一条账单都不给；换线路重试后仍是空白 |
这两种都不是账号掉线，用户重新认证往往救不回来，而且账号的其它功能（如收款账号信息）都正常。系统处置：
- 单次遇到 → 先按 上游暂时繁忙 走自动重试，不动订单状态。
- 同一张卡 连续 3 次 都是这两种表现（两种混合也累计在一起）→ 按 掉线 处理：卡转 未认证 + 停工，退出派单池，后续按第 2 节的掉线口径走。
- 中间只要有 任意一次查账成功，计数立即清零。
为何要按掉线处理：这类卡继续留在派单池里，会不断接到新单、而用户付了款平台却查不到账单，只能靠补单收尾。宁可先摘出来。
运营口径：账号真的没有交易时，钱包会返回「有账单列表、但里面是空的」，系统视为正常查账成功，不会因此判掉线。所以被判掉线的卡，确实是账单入口不可用，可引导用户先改用其它钱包收款。
4. 查到了账单但对不上
| 触发场景（通俗） | 代收 | 代付 |
|---|---|---|
| 用户 提交流水号 / 商户补单 | 可较快关单 | 审核中且卡正常时可拒绝 |
| 定时自动查账（3/8 分等） | 等到 8 分钟 再关单 | 自动阶段不立刻拒绝 |
| 8 分钟最后一搏 | 仍未匹配则关单 | — |
| 20 分钟超时前最后一搏 | — | 收款方一致且少付（实付 ≥10 卢比）则转入少付待补足；仍未匹配则子单超时 |
| 重认证后专门补救 | 仍对不上则关单 | 仍对不上可拒绝 |
| 关单后后台重试 | 对上则补单成功；对不上收敛子单 | — |
5. 重认证补救（运营指引）
5.1 用户刚完成 OTP / 更新卡
- 对该卡下所有 审核中 订单与 掉线补救标记 订单 合并串行再查账（默认 OTP 成功后约 5 秒 再调爬虫，避免 Token 尚未写入就返回掉线）。
- 未到 8 分钟关单时点：对不上也 不立刻关单。
- 已超过关单时点且仍对不上：可 自动驳回 仍挂在审核中的子单。
5.2 曾因掉线打了「补救标记」的订单
- 重认证成功后，系统 专门再查一轮（与 5.1 同一任务内优先处理标记订单）。
- 爬虫成功拉到账单但仍对不上：代收、代付均先清除掉线补救标记，再按未掉线时的正常匹配失败处理。代付已过支付超时宽限期则自动彻底拒绝；代收关单后补单 / 管理端手动查账未命中则子单回到取消或支付超时，不再因「曾掉线」一直停在审核中。若该单同时处于 账单待定 / 少付待补足 / 截图 OCR 等其它等待，仍按对应窗口继续等，不会被提前判死。
- 例外：若派单快照 UPI 与当前卡 UPI 不一致（重认证换了收款号），系统 不自动关单，子单保持审核中、余额继续冻结，见 第 6 篇 · 7.2。
- 爬虫 调用失败（含掉线 1004、上游繁忙）→ 保留补救标记，写入 自动重试队列（约每 2 分钟扫描，间隔 5→60 分钟递增）；仍失败则等其它兜底；代付 若一直无法拉到账单，最长约 48 小时 后自动彻底拒绝（与 附录：代付账单待定 一致）。
5.3 运营可做什么
- 引导用户完成 App 内 重新认证。
- 在审核页 手动通过（不依赖爬虫）。
- 核对是否应走 商户补单 / 管理端手动触发查账。
6. 关单后补单（代收）
- 主单已 取消、子单 支付超时 后，LOCAL 可写入 关单后重试队列。
- 重试前可能将子单 复活为审核中 再查账。
- 匹配成功 → 主单改 成功、商户入账、App按 第 3 篇 补单扣款。
- 重试成功拉账但仍对不上 → 子单从审核中回到 取消，主单保持取消（派单 UPI 已变更 的 hold 单除外，见 第 6 篇 · 7.2）。即使此前因掉线打过补救标记，只要本轮已拉到账单，也不再因此停在审核中。
- HIS 已耗尽（见 第 6 篇 §2.1）：此后 补单与 1009 重试 只查账单总表，命中则成功，未命中则直接失败。管理端手动爬虫 不受此限：先查账单总表，未命中时仍请求钱包实时爬虫；实时爬虫跑完仍对不上，才收敛子单并解冻。
7. 8 分钟关单被掉线打断的兜底（audit 卡单）
背景：LOCAL 代收满 8 分钟要关单时，会先做「最后一搏」查账。若此刻爬虫返回 钱包掉线（1004），子单会从 支付中 转为 审核中（保持冻结、等重认证），但正式关单这一步因此没有走完——结果主单仍 进行中（待处理）、子单停在 审核中，既没正式关单，也没判失败。
这类「卡单」过去只能靠后台 1009 重试无限查账，可能长期挂着（极端情况下隔天才偶然对上账或被人工处理）。现已补两条兜底：
| 兜底 | 触发条件 | 结果 |
|---|---|---|
| 超时驳回 | 子单 审核中 + 主单 仍进行中（或待处理且已登记 UTR）+ 已过创单 8 分钟 + 查账 成功拉到账单但仍对不上（任意触发来源，含管理端手动） | 子单 取消、主单 取消、App用户余额 加回 |
| 超时补关单 | 子单 审核中 + 主单 待处理 + 已过创单 8 分钟 + 卡已认证（每分钟定时扫描） | 子单 支付超时、主单 取消、App用户余额 加回；之后可入 关单后重试 |
仍然保持等待、不关单的情形：
- 卡未认证，且这一轮一条账单都没拉到：无法核实用户到底有没有收到钱，继续挂审核、打补救标记，等用户 OTP；此时主单会先按 软失败 取消，避免商户侧一直挂在进行中。 反之，卡虽标为未认证但本轮仍拉到了完整账单且没有这笔进账，则按正常失败 硬关并加回，不再挂等 OTP——否则每轮查账都会重新打上补救标记，订单和冻结会一直挂到 48 小时强制关单（曾出现某笔子单查账 1000 多次全部对不上，却既不判失败也不加回）。
- 派单 UPI 已变更（重认证换了收款号）：保持审核中、继续冻结，需人工处理（见 第 6 篇 · 7.2）。此时拉到的账单属于另一个收款号，「对不上」不能证明用户没收款，所以即使拉到账单也不硬关；主单同样按软失败取消。
- 用户或商户已提交流水号 的审核单：商户网关 UTR 补单激活子单时会将主单 待处理 → 进行中（与收银台提交 UTR 一致），不被定时「超时补关单」关掉；仍按提交流水号匹配、1009 重试、超关单时点驳回等规则走。若主单仍为待处理但子单已写 UTR，补关单任务亦会跳过。
运营口径：审核中 + 主单仍进行中的 LOCAL 代收，若已超过 8 分钟且查账「拉到账单但对不上」，会按失败收敛（加回余额、关主单）；只有「真的一条账单都拉不到」「换了收款号」才继续等冻结。卡显示未认证但账单能拉到，一样按失败收敛。
下一篇 → 第 8 篇：常见问题与参数表