订单主单与子单
所属：Paisa 运营人员指南 · 第 2 篇
上一篇：LOCAL 通道选卡策略 · 下一篇：三端账户余额怎么变
一笔 LOCAL 业务在系统里通常有 两层订单：商户看到的 主单，和App用户实际操作的 子单。
可以把主单理解成「商户眼里的整笔生意」，子单理解成「App用户手里正在做的那一单」。排查问题时，先确认你看的是哪一层、用的是哪个单号。
0. 为什么要分两层？
平台夹在 商户（上游） 和 App用户（下游承兑） 中间，两边关心的信息不一样：
| 角色 | 关心什么 | 对应哪一层 |
|---|---|---|
| 商户 | 我派了多少钱的单？成交没？什么时候回调？ | 主单 |
| App用户 | 我接的是哪张卡？付没付？流水号填了没？ | 子单 |
| 运营 / 客服 | 两边都要看，还要对得上 | 主单 + 子单 |
打个比方：
- 主单像商场收银台的小票总单：金额、商户单号、最终是「成交」还是「作废」。
- 子单像店员手里的操作工单：谁接单、付到哪张 UPI、现在在「等付款」还是「等对账」。
商户接口、商户后台、回调通知里说的「订单」，几乎都是 主单。App端、管理后台「用户订单明细」、Telegram 里「子订单号」，指的是 子单。
1. 主单（商户订单）
1.1 主单是什么
主单 = 商户发起的那笔 整单代收或代付。
创建时就会生成，贯穿从创单到回调的全过程；状态相对简单，只有 4 种业务说法。
| 状态（业务说法） | 通俗含义 | 商户侧感受 |
|---|---|---|
| 待处理 | 单已创建，还没进入「有人在做」的阶段 | 代收：已拿到收款码，等付款人付钱；代付：在大厅等人抢 |
| 进行中 | 已经有人接单，或已提交凭证进入核对 | 钱在路上或对账中，还没最终定论 |
| 成功 | 整单成交，资金与回调按规则落地 | 商户收到成功回调，余额按规则变动 |
| 取消 | 失败或关闭，不再继续 | 代收：不自动回调，商户需查单；代付：收到取消/失败类回调 |
主单 不会 细分到「等填流水号」「账单待定」这类细节——那些都在子单上体现；主单只回答：这单整体还在不在做、最后成没成。
1.2 代收 vs 代付：主单节奏不一样
LOCAL 代收（用户向商户充值）
- 商户创单 → 系统选卡派单 → 主单多为 待处理（收款码已出，等付款人扫码）。
- 付款人提交银行流水号，或系统自动对账认定「有人在做」→ 主单变 进行中。
- 账单核对通过 → 主单 成功；超时关单、用户取消、对账失败 → 主单 取消。
代收主单从创单起通常就 绑定了唯一一张派单卡（对应一条有效子单），不会多人抢同一主单。
LOCAL 代付（商户向用户提现）
- 商户创单 → 钱从可用余额划入 代付冻结池（总资金没少，见 第 3 篇）→ 主单 待处理。
- App用户抢单成功 → 主单 进行中（此时才锁定「当前在做」的那条子单）。
- 子单对账成功 → 主单 成功；子单超时、匹配失败等 → 主单往往回到 待处理，可再次抢单（不是立刻整单作废）。
代付主单在「待处理」时，大厅里可以被很多人点抢，但 同一时刻只有一条子单算有效。多人几乎同时点抢时，系统会 先把主单锁给最先成功的那位，只为他创建一条子单；没抢到的人不会产生任何子单记录，只会收到「该订单已被抢」的提示，之后仍可继续抢这一主单（不计入「不得再买同一主单」或连续取消流转计数）。
早期版本会为抢输的人也留下一条「取消」子单（原因「已被他人接单」），现已优化为不再产生；历史数据中若仍能查到这类取消记录，同样不视为App用户主动放弃。
1.3 主单号在哪里看
| 位置 | 说明 |
|---|---|
| 管理后台「订单明细」 | 商户订单号 列即主单对外编号 |
| 商户 API / 回调 | 商户传入或平台返回的 orderId |
| App端 | 一般不直接展示主单，看子单即可 |
和商户沟通时，优先用 商户订单号（主单） 定位；和App用户沟通时，用 子订单号 更准。
2. 子单（App用户订单）
2.1 子单是什么
子单 = App用户 接单、付款、上传凭证、被爬虫对账 的那一条工单。
状态比主单 细得多，因为运营和客服需要知道「卡在哪一步卡住了」。
| 状态（业务说法） | 通俗含义 | 常见下一步 |
|---|---|---|
| 支付中 | 等人付钱或等App用户出款 | 付款完成 / 提交流水号 / 超时 |
| 审核中 | 已提交流水号或截图，系统在拉账单或对账 | 成功 / 失败 / 继续等（如账单待定） |
| 成功 | 对账通过，这一单子单成交 | 主单通常也变成功 |
| 取消 | 用户或系统主动结束本笔子单 | 代收常伴随主单取消；代付可能主单回待处理 |
| 支付超时 | 超过支付时限未成交 | 资金按规则加回；代收主单多变为取消 |
| 失败-处理倒计时 | 对账没对上，进入申诉/处理倒计时 | 用户补材料或倒计时结束后失败 |
| 失败(pending)-上传文件 | 等平台或用户补材料 | 上传后可能重新进入审核 |
| 订单失败 | 子单终态失败 | 代付常见主单回待处理可再抢 |
记忆窍门：子单状态回答的是「App用户这一侧做到哪了」；主单状态回答的是「商户那一整单最后什么结果」。
2.2 代收 vs 代付：子单节奏不一样
LOCAL 代收
- 派卡成功时 立刻创建一条子单，状态 支付中；一般 一主单对应一有效子单。
- 付款人提交 UTR → 子单 审核中；未提交则靠定时自动查账（约 8 分钟内，见 第 4 篇）。
- 成功：子单 成功，主单 成功；关单：子单多为 支付超时 或 取消，主单 取消，App用户余额加回。
LOCAL 代付
- 创单时 不 立刻有有效子单；用户 抢单成功 才创建子单 支付中，并启动 20 分钟 支付倒计时（与代收 8 分钟不同，见 第 5 篇）。
- 提交流水号或截图 → 子单 审核中；可能出现少付待补、账单待定等中间态，主单保持 进行中。
- 子单 成功 → 主单 成功；子单 支付超时 → 主单常回 待处理，单子回到大厅可再抢（除非触发连续取消流转等规则）。
- 子单经 申诉期 仍 失败（倒计时到期或管理员复审拒绝）→ 主单 取消，向商户发 取消回调，不再 回大厅。
- 子单 彻底拒绝（跳过申诉）→ 子单失败，主单仍回 待处理 可再抢。
2.3 子单号在哪里看
| 位置 | 说明 |
|---|---|
| 管理后台「用户订单明细」 | 子单列表，状态最细 |
| App端 订单详情 | 用户日常操作的单号 |
| Telegram / 内部通知 | 「子订单号」一般指这里 |
同一主单在代付场景下，历史上可能有多条子单（多次抢单、取消、超时），只有当前锁定的那条 代表「正在做的这一笔」。
3. 主单与子单如何对应
3.1 对应关系（记住这三条）
- 代收：主单创单并派卡时，通常 只锁定一个有效子单；主单与子单一一对应走完流程。
- 代付：主单「待处理」时 还没有 有效子单；抢单后才创建。主单「进行中」时 锁定当前子单；抢输产生的子单会 取消，不算有效单。
- 状态不同步是正常的：代付子单失败了，主单可能仍是 待处理（等下一个人抢），而不是 取消——这是设计如此，方便继续撮合。
3.2 常见状态组合（查单速查）
| 场景 | 主单 | 子单 | 说明 |
|---|---|---|---|
| 代收刚派卡 | 待处理 | 支付中 | 等付款人扫码付钱 |
| 代收已填 UTR | 进行中 | 审核中 | 系统在拉账单对账 |
| 代收 8 分钟关单 | 取消 | 支付超时 | App用户余额会加回；对用户可能显示不太显眼 |
| 代付无人抢 | 待处理 | （无有效子单） | 钱在代付冻结池，不是丢了 |
| 代付抢单后出款中 | 进行中 | 支付中 | 20 分钟倒计时内 |
| 代付对账中 | 进行中 | 审核中 | 含账单待定、少付待补等 |
| 代付子单失败可再抢 | 待处理 | 失败 / 支付超时 | 主单未作废，可再次撮合 |
| 整单成交 | 成功 | 成功 | 资金与回调落地 |
4. 排查时最容易搞混的几件事
「商户说订单进行中，App端 显示支付中」
→ 正常。进行中 / 支付中 是不同层的说法，表示「有人在付、还没最终成功」。
「主单取消了，子单还能成功吗？」
→ LOCAL 代收关单后，后台仍可能在一段时间内继续查账；对上了可以 补单复活（主单从取消改回成功）。见 第 7 篇。
「子单是支付超时，钱加回了吗？」
→ 会加回。支付超时是系统关单用语，资金上与取消类关单一样解冻App用户余额。见 第 3 篇。
「代付子单失败，主单为什么还是待处理？」
→ 这是刻意的：方便放回大厅再抢。只有连续失败、流转下游或商户取消等规则触发时，主单才会整单 取消。流转机制详见 第 5 篇 · 第 7 节。
「一笔主单为什么有多条子单？」
→ 代付常见：多人抢过、超时、取消都会留下记录；看状态为支付中 / 审核中的那条，或时间最新且未终态失败的那条。
「子单都失败了，商户怎么还收到成功回调？」
→ 多见于 LOCAL 代付已流转到外部通道：App侧子单记录的是 LOCAL 阶段的抢单、超时、取消，看起来「全黄了」；但主单在 待处理 时已改派给其他下游，由该通道完成出款并回调 成功。查单时以 主单状态 + 通道编码 为准——若通道已非 LOCAL，子单列表里的失败记录不代表最终成交路径。详见 第 5 篇 · 第 7 节。
5. 代付主单流转（速览）
LOCAL 代付主单长时间 待处理（没人抢或反复抢了又黄），平台可以把单子 改派给其它下游，商户订单号与冻结资金不变。完整说明见 第 5 篇 · 第 7 节，此处只记三点：
- 只有「待处理 + LOCAL」能流转；有人正在做（主单进行中）时不能转。
- 流转成功：主单仍待处理，但通道可能变成外部三方——App大厅不再展示，由新通道接手。
- 触发来源：运营手动、池子水位/超时自动、连续子单取消达阈值、挂单过久硬兜底；全失败则整单取消退商户。
6. 和后续章节的关系
下一篇 → 第 3 篇：三端账户余额怎么变