异常、重试与重认证
爬虫或账单匹配不顺利时，系统不会一律立刻关单。本篇按 钱包掉线、上游繁忙、查到了但对不上、重认证 四类说明。
1. 总览决策（无技术错误码）
2. 钱包掉线 / 卡未认证
| 表现 | 系统行为 | 代收App用户余额 |
|---|---|---|
| 爬虫提示 登录失效 或卡 未认证 | 关单前不因掉线立刻关单（代收支付中 / 审核中）；关单后复活遇 1004 仍收敛子单 cancel（余额已在关单时处理） | 关单前不加回；关单后复活不再动余额 |
| 代收 审核中 订单 | 打 等重认证补救 标记 | 不加回 |
| 代收 未满 8 分钟 就掉线 | 子单保持原状态；通知用户 OTP | 不加回 |
| 代收 满 8 分钟 要关单，但卡未认证 | 子单转 审核中 + 标记，主单不关 | 不加回，继续占用直至成交或最终关单 |
| 代收 满 8 分钟 要关单，且卡已认证 | 正常关单（子单支付超时，主单取消） | 加回 |
| 代付 支付中 超时 | 仍按原逻辑 支付超时（代付不等卡认证） | 代付不动App用户余额（见 第 3 篇） |
| 代付 审核中 且卡掉线/未认证 | 打 等重认证补救 标记；一直拉不到账单时最长约 48 小时自动彻底拒绝 | 代付不动App用户余额 |
| 用户完成 OTP / 重绑卡 | 见第 3、5 节 | 对上则成交；已拉到账单仍对不上则按未掉线正常失败处理（不再因补救标记长期 hold） |
运营口径：掉线 = 「暂时查不了账」，不是「订单失败」。在重认证或其它兜底之前，App侧 不要 按关单解释余额变动。资金细节见 第 3 篇 · 2.7。
与 第 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 小时 仍未匹配 → 自动彻底拒绝 |
| 运营操作 | 审核页可手动通过/拒绝；也可点「爬虫重试」加速对账 |
4. 查到了账单但对不上
| 触发场景（通俗） | 代收 | 代付 |
|---|---|---|
| 用户 提交流水号 / 商户补单 | 可较快关单 | 审核中且卡正常时可拒绝 |
| 定时自动查账（3/8 分等） | 等到 8 分钟 再关单 | 自动阶段不立刻拒绝 |
| 8 分钟最后一搏 | 仍未匹配则关单 | — |
| 20 分钟超时前最后一搏 | — | 仍未匹配则子单超时 |
| 重认证后专门补救 | 仍对不上则关单 | 仍对不上可拒绝 |
| 关单后后台重试 | 对上则补单成功；对不上收敛子单 | — |
5. 重认证补救（运营指引）
5.1 用户刚完成 OTP / 更新卡
- 对该卡下所有 审核中 订单与 掉线补救标记 订单 合并串行再查账（默认 OTP 成功后约 5 秒 再调爬虫，避免 Token 尚未写入就返回掉线）。
- 未到 8 分钟关单时点：对不上也 不立刻关单。
- 已超过关单时点且仍对不上：可 自动驳回 仍挂在审核中的子单。
5.2 曾因掉线打了「补救标记」的订单
- 重认证成功后，系统 专门再查一轮（与 5.1 同一任务内优先处理标记订单）。
- 爬虫成功拉到账单但仍对不上：代付 清除掉线补救标记，按未掉线时的正常匹配失败处理（已过支付超时宽限期则自动彻底拒绝），不再因「曾掉线」一直 hold 到 48 小时。若该单同时处于 账单待定 / 少付待补足 / 截图 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。
- 派单 UPI 已变更（重认证换了收款号）：保持审核中、继续冻结，需人工处理（见 第 6 篇 · 7.2）。
- 用户或商户已提交流水号 的审核单：商户网关 UTR 补单激活子单时会将主单 待处理 → 进行中（与收银台提交 UTR 一致），不被定时「超时补关单」关掉；仍按提交流水号匹配、1009 重试、超关单时点驳回等规则走。若主单仍为待处理但子单已写 UTR，补关单任务亦会跳过。
运营口径：审核中 + 主单仍进行中的 LOCAL 代收，若已超过 8 分钟且查账「拉到账单但对不上」，会按失败收敛（加回余额、关主单）；只有「掉线查不了账」「换了收款号」「卡未认证」才继续等。
下一篇 → 第 8 篇：常见问题与参数表