三端账户余额怎么变
所属：Paisa 运营人员指南 · 第 3 篇
上一篇：订单主单与子单 · 下一篇：LOCAL 代收全流程
排查「钱去哪了」时，先分清 商户平台账户、App用户余额、代收冻结登记 三样东西。本篇说明 LOCAL 代收/代付在各节点如何变动。
1. 三类账户（通俗对照）
| 账户 | 谁 | 文档里怎么称呼 |
|---|---|---|
| 商户平台账户 | 发起代收/代付的商户 | 商户余额（含「可用余额」+「代付冻结池」） |
| App用户账户 | 接单卖币/买币的承兑用户 | App用户余额（App 里看到的可用余额） |
| 代收冻结登记 | 系统为每笔 LOCAL 代收记的占用/待扣明细 | 代收冻结登记（冻结中用于 Selling 展示；延迟待扣不垫高余额） |
2. LOCAL 代收 · App用户
2.1 派单成功瞬间
- App 可用余额立刻减少 订单金额（余额不够则派单失败，见 第 1 篇）。
- 系统记一笔 代收冻结登记 · 冻结中：表示这笔钱被本单占用，不能再接同额度单。
2.2 订单成功
- App用户余额 不再扣第二遍（派单时已扣）。
- 登记改为 已消费：表示占用正式算作卖币成交。
2.3 取消 / 超时关单 / 用户确认失败
- App用户余额 加回 订单金额。
- 登记改为 已解冻。
2.4 关单后补单成功
- 主单曾「取消」、登记已是「已解冻」时，补单成功会从App用户余额执行首批实扣，不会把
account.balance扣成负数。 - 若余额足以清偿剩余金额，尾款可一次扣清（不要求整百）；否则只扣余额内可用的整百卢比。
- 未扣部分登记为 延迟待扣 remaining。后续充值或加款后按订单创建顺序继续实扣，每批各写一条 Sell 明细。
- 例：余额 ₹456、补单 ₹1000，先扣 ₹400，余额 ₹56、remaining ₹600；充值 ₹460 后余额 ₹516，再扣 ₹500，remaining ₹100。
2.8 延迟待扣（补单尚未扣完）
订单已成功、商户已入账，但补单金额尚未从App用户余额扣完时，系统登记 延迟待扣。
| 场景 | App balance |
登记状态 | 用户看到的余额 |
|---|---|---|---|
| 进行中成功 | 不变（派单已扣） | 冻结中 → 已消费 | 不变 |
| 补单成功、余额不足 | 仅扣可用整百，保持非负 | 已解冻 → 延迟待扣 | 直接显示真实 account.balance |
| 后续加款 | 每批继续实扣 | remaining 递减 | 随实扣同步下降 |
| 尾款清零 | 扣清尾款 | 延迟待扣 → 解冻后消费 | 真实余额 |
用户可见余额与派单口径：
首页大余额 = account.balance
接口对账总额 = account.balance + SUM(代收冻结登记金额 WHERE 状态为「冻结中」)
- remaining 不再垫高任何余额展示。
- 用户存在 remaining 时暂停 LOCAL 新派单；先还旧债，清零后自动恢复资格。
- 结算触发：用户充值/余额加回后自动尝试 + 约 60 秒定时兜底；按登记 ID 正序 FIFO，前一笔无法扣出整百且不能清尾时停止。
- App 成功订单在 remaining 未清时显示黄色 Success，清零后变为绿色；订单详情可查看每批扣款金额与时间。
- 管理端误判修复（成功→取消）：延迟待扣只退还该单已实际扣除的金额
frozen_price - remaining；同时扣回商户此前入账净额，并向商户发取消回调。
2.5 商户侧（代收）
- 创单时 不冻结 商户余额。
- 仅 成功 后，按实收金额（扣手续费后）增加商户可用余额 并通知商户。
- 管理端确认「成功误判」改回取消时：扣回 此前入账净额（手续费随净额回滚，平台不再保留该笔服务费），并补发 取消回调。
2.6 App用户余额什么时候会加回（解冻）
只要登记还是 冻结中，App端 里看到的可用余额就比「可接单总额」少一笔；加回 时登记改为 已解冻。下面按「谁触发的」分组，便于客服对账。
会加回的情况
| 类型 | 通俗场景 | 子单常见终态 | 主单 |
|---|---|---|---|
| 系统超时关单 | 创单满约 8 分钟 仍对不上账；收银台倒计时结束；或支付倒计时字段到期 | 支付超时（对用户侧不太显眼） | 取消 |
| 主动关单 | 商户接口取消、App用户取消、收银台点「支付失败」 | 取消 | 取消 |
| 查账后认定失败 | 已提交流水号 / 商户补单后，账单拉到了但对不上（且不属于「掉线等等」） | 取消 | 取消 |
| 重认证后仍失败 | 卡已重新 OTP，专门再查一轮，账单拉到了仍对不上，且已过 8 分钟关单时点 | 取消 | 取消 |
| 管理端纠偏 | 订单曾被判成功，运营确认误判后改回取消 | 取消 | 取消 |
说明：子单终态是「支付超时」而不是「取消」时，对用户来说不一定像点了失败，但App用户余额 同样会加回；商户侧仍会收到 取消类 回调。关单后若后台又对上了账，可走 补单复活（见 2.4）。
不会加回的情况（钱仍被本单占用）
| 通俗场景 | 子单/主单 | 登记与余额 |
|---|---|---|
| 订单 支付中 / 审核中，正常等查账 | 进行中 | 冻结中，余额不加回 |
| 钱包掉线（登录失效），支付 未满 8 分钟 | 保持原状态 | 冻结中，等用户重认证 |
| 上游暂时繁忙，拉账失败 | 保持原状态 | 冻结中，等自动重试 |
| 定时自动查账（3 分钟）未匹配 | 仍支付中 | 冻结中，等到 8 分钟再关 |
| 满 8 分钟 要关单，但卡 未认证 / 掉线 | 转 审核中 + 打「等重认证」标记；主单不关 | 冻结中，引导 OTP |
| 关单后补单 复活查账中 | 主单仍取消，子单可能回到审核中 | 关单时已加回；补单成功会 再扣 |
2.7 钱包掉线时，余额动不动？
支付还没超时（未满约 8 分钟）时，钱包掉线不会加回App用户余额。
系统会把接单卡标为 未认证，并通知用户重新 OTP；审核中的单会打 等重认证 标记。此时：
- 子单 不会 因掉线立刻关单；
- App用户余额 继续占用，登记仍是 冻结中；
- 用户完成重认证后，系统会 专门再查一轮；对上则成交，仍对不上且已过关单时点才关单并加回。
与「账单拉到了但对不上」不同：后者在部分场景下会较快关单并加回；掉线属于「暂时查不了账」，要先等重认证或其它兜底。
资金变动一览（App + 商户）
3. 代付 · 商户平台（含 LOCAL）
| 节点 | 可用余额 | 代付冻结池 | 商户总资金 |
|---|---|---|---|
| 商户发起代付 | 减少（划出本单实际应付） | 增加相同金额 | 不变 |
| 代付成功 | 不变 | 减少 | 钱已真正付出 |
| 代付整单取消/驳回 | 加回 | 减少 | 不变 |
| LOCAL 子单超时、主单回待处理 | 不变 | 不变 | 仍冻结，等下一用户抢单 |
「实际应付」= 订单金额 + 商户侧代付手续费等，以创单时系统计算为准。
4. LOCAL 代付 · App用户
| 阶段 | App用户余额 |
|---|---|
| 抢单 → 支付中 → 审核中 | 不变（用户在自家钱包 App 向终端付款） |
| 子单确认成功 | 增加（订单金额 + 平台奖励等），并记账户流水；返佣/代理分润另记 |
管理端「用户账户明细」中，每条流水的变动前/变动后快照包含三项：可用余额（账户可用）、冻结余额（LOCAL 代收进行中占用）、延迟待扣（补单成功但余额不足、待后续结算）。LOCAL 代收派单冻结/解冻本身不产生流水，仅在有入账/出账流水时快照当时的冻结与延迟状态。
代付成功入账时，订单金额（Buy）与平台奖励（Income）分两条流水写入，前后快照各自对应本条金额变动（先记本金再记奖励，链式衔接）。USDT 充值同理：本金与充值佣金分两条流水、各自一笔一计。金额为 0 的部分不写空明细。历史已写入的双明细若前后快照相同，属于改造前旧口径，不影响最终余额。
5. 业务节点速查表
| 业务节点 | 商户余额 | App用户余额 | 代收冻结登记 |
|---|---|---|---|
| LOCAL 代收派单 | 不变 | 减少 | 冻结中 |
| LOCAL 代收成功 | 增加实收 | 不变（已扣过） | 已消费 |
| LOCAL 代收取消/超时 | 不变 | 加回 | 已解冻 |
| LOCAL 代收掉线/繁忙（未满 8 分） | 不变 | 不加回 | 冻结中 |
| LOCAL 代收 8 分关单但卡未认证 | 不变 | 不加回 | 冻结中（转审核中等 OTP） |
| LOCAL 代收补单成功 | 增加实收 | 整百分批实扣，不足部分待扣 | 延迟待扣或解冻后消费 |
| 代付创单 | 可用↓ 冻结池↑ | 不变 | — |
| 代付成功 | 冻结池↓ | 增加 | — |
| 代付整单取消 | 可用↑ 冻结池↓ | 不变 | — |
| LOCAL 代付子单超时 | 不变（仍冻结） | 不变 | — |
6. 运营常见误解
| 问题 | 说明 |
|---|---|
| 代收成功了，App用户余额为什么没再少？ | 派单时已扣；成功只改登记为「已消费」。 |
| 代付还在「待处理」，商户可用余额怎么少了？ | 创单时已划入代付冻结池，总资金未消失。 |
| 为什么余额很多却接不到新单？ | 首页与 Telegram 直接显示 account.balance；若仍无法接单，先查是否存在补单 remaining。待扣债务清零前会暂停 LOCAL 新派单。 |
| 钱包掉线了，App用户余额怎么没加回？ | 掉线不等于关单；未满 8 分钟或卡在等 OTP 时，钱仍被本单占用。见 2.7、第 7 篇。 |
| 子单是「支付超时」不是「取消」，钱加回了吗？ | 会加回；「支付超时」是系统关单用语，资金上与取消一样解冻。见 2.6。 |
| 主单取消了，冻结登记怎么还是冻结中？ | 关单瞬间应已 已解冻；若仍显示占用，查是否关单流程未走完，或正在走关单后补单复活。 |
下一篇 → 第 4 篇：LOCAL 代收全流程