进阶 钱包计费

💰钱包充值与按量计费对账

搞懂 SimSmsBox 的钱包模型:如何充值、按单扣费规则、失败退款、以及如何拉取流水做对账,帮财务和技术对齐每一笔花费。

✍️ SimSmsBox 📅 2026年6月12日

SimSmsBox 采用钱包预充值 + 按单扣费模型。这篇教程帮你把「钱怎么花的」彻底搞清楚,方便对账。

计费模型一图流

  1. 先给钱包充值,形成可用余额;
  2. 每次成功取号按该订单单价扣费;
  3. 未收到验证码的订单自动退款,不产生费用;
  4. 所有变动都会写入钱包流水。

核心原则:失败不收费。这让批量业务的成本可预期。

第一步:查询余额

curl https://api.simsmsbox.com/api/sms/wallet/balance \
  -H "X-API-Key: psk_xxx"

返回:

{ "balance": 128.50, "currency": "USDT" }

第二步:拉取流水做对账

curl "https://api.simsmsbox.com/api/sms/wallet/txs?page=1&pageSize=50" \
  -H "X-API-Key: psk_xxx"

每条流水通常包含:

字段说明
typerecharge(充值) / charge(扣费) / refund(退款)
amount金额(正为入账,负为出账)
orderId关联订单(扣费/退款时有值)
createdAt时间(北京时间)

第三步:对账思路

把一段时间内的流水按 type 汇总:

期末余额 = 期初余额 + Σ充值 - Σ扣费 + Σ退款

只要这条等式成立,账就是平的。建议每日定时拉取并入库,形成自己的对账表。

设个余额水位告警

批量业务务必避免「跑到一半没钱」。在你的监控里加一条规则:

if balance < 阈值: 触发告警 / 自动充值

下一步

← 返回教程列表