跳到主要内容

钱包业务逻辑基础

本章帮助新人快速理解 钱包 的 核心业务结构。
重点是让新人弄清楚：

  • 钱包有哪些交易模式？
  • 钱包如何与盘口交互？
  • 钱包如何与四方商户交互？
  • 钱包为何既处理积分，又处理 INR？
  • 售卖为什么叫代收？购买为什么分为代付单/代收单？

一、钱包的两个交易模式（全局总览）​

钱包所有业务本质上可以拆成两类：

1.1 与盘口的交易（纯积分模式）​

此模式涉及：

  • 盘口在钱包的积分额度
  • 阿三钱包余额

这些都是 积分变化，不涉及真实 INR。

包含两类行为：

  • 充值（代收）
  • 提现（代付）

关键认知：

钱包与盘口之间不发生 INR 结算，
只发生“积分 + / -”。

阿三得到的是钱包余额（虚拟积分），不是 INR。

1.2 钱包内部购买 / 售卖（真实 INR 流动）​

此模式涉及：

  • 阿三 ↔ 四方之间真实 INR 的收/付
  • 钱包 ↔ 四方之间积分的 + / -

包含三类行为：

  • 售卖（四方积分 +）
  • 购买 - 代付单（四方积分 -）
  • 购买 - 代收单（钱包积分 +）

关键认知：

钱包从不触碰 INR。
INR 只在阿三与四方之间流动。
钱包只记录积分账务。
钱包和商户、四方的利润是依靠内充和下发完成

1.3 究竟什么是统一账务体系？​

阿三看到的是 INR。
钱包看到的是积分（内部账务）。
盘口看到的是积分。
四方看到的也是积分。

因此：

真实世界里流动的是 INR；
钱包世界里流动的是“积分”。

1.4、商户（Merchant）概念说明​

在钱包账务体系中：

  • 盘口（提供充值/提现场景）
  • 四方（UPI 通道商户，向阿三收/付 INR）

虽然角色不同，但本质相同：

所有通过积分与钱包结算的合作方都属于“商户”。

区别：

  • 盘口：帮助自己的会员完成充值/提现
  • 四方：帮助钱包与阿三之间产生 INR 交易，并通过积分与钱包对账
信息

后续文档中，“商户”一般指 四方。
“盘口”保留作为单独角色。

二、模式 A：与盘口之间的交易（纯积分）​

此模式下，所有行为都是 积分变化，与 INR 无关。

2.1 为什么充值叫代收？​

阿三在盘口充值时：

  1. 钱包扣减阿三的钱包余额
  2. 盘口给阿三增加盘口积分
  3. 钱包给盘口积分 +

从账务角度：

钱包替盘口“收进了一笔积分”。
因此充值 = 代收（Collect）。

充值时序图

2.2 为什么提现叫代付？​

阿三在盘口提现时：

  1. 盘口扣减阿三的盘口积分
  2. 钱包给阿三增加钱包余额
  3. 钱包给盘口积分 -

从账务角度：

钱包替盘口“付出了一笔积分”。
因此提现 = 代付（Pay）。

提现时序图

三、模式 B：钱包内部购买 / 售卖（涉及真实 INR）​

这是钱包中最复杂、最重要的部分。
特点：

  • INR 在阿三 ↔ 四方之间流动
  • 积分在钱包 ↔ 四方之间变化

钱包内部的购买/售卖 = 真实 INR 世界 + 积分账务世界 的结合体。

模式 B 一共分三类：

  1. 售卖（四方代收 → 四方积分 +）
  2. 购买 - 代付单（四方代付 → 四方积分 -）
  3. 购买 - 代收单（四方上游 → 钱包积分 +）

下面逐一说明。

3.1 售卖：为什么叫“代收”？​

（核心：钱包把代收量转给四方使用，把钱包阿三的收款 UPI 借给四方使用）

阿三售卖 1000 时：

  1. 钱包扣减阿三余额 -1000
  2. 钱包把“阿三的收款 UPI”借给四方使用
  3. 四方通过这条 UPI 向阿三支付 1000 INR
  4. 钱包给四方积分 +1000

钱包阿三视角：

“我收到钱了。”

钱包视角：

“我的阿三帮四收了一笔钱，所以我给四方加分。”

所以售卖 = 四方代收积分 +

售卖时序图

3.2 购买：分为两类订单​

A. 代付单（Bank / UPI 订单）​

→ 钱包阿三去付款
→ 四方积分 减少

流程：

  1. 四方向钱包提交一笔“需要付款给某人”的代付订单
  2. 钱包阿三用自己的付款 UPI 打款 1000 INR
  3. 钱包给该阿三增加钱包余额 +1000
  4. 钱包给四方积分 -1000（钱包帮四方代付）

阿三看到：

“我打了 1000 INR，系统给我 1000 钱包余额。”

钱包看到：

“四方让我帮他打钱，所以我从四方扣 1000 积分。”

购买 - 代付单 时序图

B. 代收单（Market 订单）​

→ 钱包阿三向四方付款
→ 四方作为上游给钱包积分 增加

流程：

  1. 钱包阿三向四方的 UPI 支付 1000 INR
  2. 四方作为上游，收到这笔 INR
  3. 四方向钱包加分 +1000（视为四方“代收”）
  4. 钱包给阿三增加钱包余额 +1000

阿三看到：

“我付了 1000 INR，钱包给我加了余额。”

钱包看到：

“我的阿三给四方打了1000，所以四方给我加分1000”

此时角色互换：

  • 四方是钱包的“上游商户”
  • 钱包是四方的“下游商户”

购买 - 代收单 时序图

四、两个模式的统一逻辑​

要彻底理解钱包，你必须掌握以下三点：

✅ 1. 钱包永远只处理积分​

无论：

  • 充值 / 提现（盘口）
  • 售卖
  • 购买（代付单 / 代收单）

钱包永远只记录：

  • 盘口积分 + / -
  • 商户积分 + / -
  • 阿三钱包余额 + / -

钱包从不参与 INR 清算。

✅ 2. INR 世界与积分世界分离​

INR 只在：

  • 阿三 ↔ 盘口
  • 阿三 ↔ 商户

之间流动。

钱包是纯账务系统（积分宇宙）。

✅ 3. 商户积分 + / - = 商户与钱包的全部关系​

  • 商户积分 + = 商户代收
  • 商户积分 - = 商户代付
  • 购买的代收单 = 角色互换，由商户给钱包加分

最终：

  • 商户积分过高 → 钱包需要“下发”
  • 商户积分为负或不足 → 商户需要“内充”

详细机制将在《结算体系与额度对冲逻辑》中说明。

五、统一模型图（INR 世界 vs 积分世界）​

六、总结​

新人必须掌握的核心认知：

  1. 充值 / 提现 = 盘口的代收 / 代付（纯积分）
  2. 售卖 = 代付（提现）转代收（售卖）（商户积分 +）
  3. 购买（代付单）= 商户代付（商户积分 -）
  4. 购买（代收单）= 商户作为上游，为钱包代收（钱包积分 +）
  5. 钱包从不处理 INR，只处理积分
  6. 积分最终通过内充 / 下发与商户结算

理解这一篇后，就能学习下一篇：

《钱包结算体系与额度对冲逻辑》
—— 钱包为什么不会亏钱？积分如何平衡？为什么必须内充？下发怎么做？