SimSmsBox 采用钱包预充值 + 按单扣费模型。这篇教程帮你把「钱怎么花的」彻底搞清楚,方便对账。
计费模型一图流
- 先给钱包充值,形成可用余额;
- 每次成功取号按该订单单价扣费;
- 未收到验证码的订单自动退款,不产生费用;
- 所有变动都会写入钱包流水。
核心原则:失败不收费。这让批量业务的成本可预期。
第一步:查询余额
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"
每条流水通常包含:
| 字段 | 说明 |
|---|---|
type | recharge(充值) / charge(扣费) / refund(退款) |
amount | 金额(正为入账,负为出账) |
orderId | 关联订单(扣费/退款时有值) |
createdAt | 时间(北京时间) |
第三步:对账思路
把一段时间内的流水按 type 汇总:
期末余额 = 期初余额 + Σ充值 - Σ扣费 + Σ退款
只要这条等式成立,账就是平的。建议每日定时拉取并入库,形成自己的对账表。
设个余额水位告警
批量业务务必避免「跑到一半没钱」。在你的监控里加一条规则:
if balance < 阈值: 触发告警 / 自动充值