文档中心 / SmartSweep 资金归集
SmartSweep 资金归集详解:触发条件、阈值与常见疑问
客户付的钱先进入专属充值地址,再由 SmartSweep 自动汇入你的冷钱包。这一步没有私钥参与,但有几条规则值得提前了解。
先看结论:SmartSweep 会把客户充值地址里的资金,通过链上合约自动转入你的冷钱包,不需要手动转账,也不暴露私钥。它按三种条件之一触发:金额、充值地址数量或时间。另外,一个充值地址要先达到一次性的最低余额(默认约相当于 5 美元),才会被归集。
1. SmartSweep 是什么
每位客户付款时,看到的是系统为他生成的专属充值地址。钱先进入这个地址,再由 SmartSweep 汇集到你指定的冷钱包。官方把这个功能称为“智能归集”(Smart Consolidation),也叫资金归集(Fund Sweep)。
- 省事:不用逐个地址手动转账。
- 安全:归集通过智能合约完成,不需要用私钥签名,也就不用把私钥放在服务器上。
- 可追溯:每一笔归集都有记录,在后台的 SmartSweep 面板里可以查看。
- 省费用:把多个小额充值合并成较少的交易,减少链上手续费。
在 PayRamHost,服务费在同一笔链上交易里拆分,所以不需要另行结算。
2. 三种触发条件
激活钱包之后,系统按你设置的三种条件之一决定什么时候归集:
| 条件 | 什么时候触发 |
|---|---|
| 金额(Amount) | 单个充值地址的余额达到设定金额;或者一批充值地址的总余额达到设定金额 |
| 地址数量(Address count) | 收到过款项的充值地址累计达到设定数量 |
| 时间(Time) | 距离上一次归集经过了设定的时间 |
这些阈值可以调整。金额设得越高,归集越少、gas 越省,但资金在充值地址里停留得越久;设得越低则相反。多数商家会先用默认值,运行一段时间后再按实际流水调整。
3. 为什么小额测试没有归集
一个充值地址要先达到一次性的最低余额(默认约相当于 5 美元),系统才会为它部署智能钱包合约。达不到,这个地址就保持“休眠”,不会被归集。
所以第一次用 1 美元测试,能验证“支付页和到账检测是否正常”,但不会立刻在冷钱包里看到这笔钱。想验证归集本身,需要让同一个充值地址累计收到超过最低余额的金额。这个最低余额也可以调整。
4. 归集的 gas 由谁出
归集是一笔链上交易,需要付 gas。它从热钱包支付,也就是由商家承担,不包含在服务费内。热钱包余额耗尽时,系统无法支付归集所需的 gas,资金就会停留在充值地址里,直到你给热钱包充值。详见 钱包分工。
5. 比特币为什么不一样
以太坊系(Ethereum、Base、Polygon)和 Tron 的归集,都通过你已经部署的归集合约自动完成。比特币链上没有这种智能合约,所以官方的比特币归集是用 PayRam 的比特币手机应用,按一套单独的流程把资金从比特币充值钱包转到你的钱包。
PayRamHost 目前开放的是 Ethereum、Base 和 Polygon,Tron 与 Bitcoin 在计划中,所以你暂时不会遇到比特币的归集流程。
6. 资金没有归集时的排查清单
- 金额够不够:这个充值地址的累计余额是否达到最低余额。没有的话它是休眠的。
- 触发条件满足了吗:金额、地址数量、时间三种条件,是否至少有一种已经达到。
- 热钱包有没有币:热钱包是否还有足够的原生币付 gas。Ethereum、Base 用 ETH,Polygon 用 POL。
- 合约部署了吗:你收款的那条链,是否已经完成“部署合约”。后台里显示 1/3 ready 表示三条 EVM 链里只有一条完成。
- 客户有没有绕过付款页:付款页只会显示你已经启用并部署了钱包的币种和网络。如果客户直接向地址转账,选错了链或币种,资金可能不会被识别或归集。
排查完仍然找不到原因,请联系我们,并提供支付的 reference_id。
7. 常见问题
归集需要我手动操作吗?
不需要。条件满足后系统自动发起,你只需要保证热钱包里有足够的 gas。
归集会不会动用我的私钥?
不会。归集通过智能合约完成,不使用私钥签名。服务器上唯一的私钥是热钱包的,用来付 gas 和出款。
每笔付款都会触发一次归集吗?
不是。归集由阈值触发,多笔小额付款可以合并成一次归集,以节省手续费。
资金停在充值地址里安全吗?
充值地址的密钥不在服务器上,资金在链上,只有归集合约会把它转到你预先设置的冷钱包。冷钱包地址是最关键的一环,请反复核对。
相关阅读
- 钱包分工:弄清楚 PayRam 里四种钱包各自的作用:主账户部署合约,充值钱包接收客户付款,冷钱包存放最终资金,热钱包只负责付 gas 和出款,以及各自该放多少钱、私钥放在哪里。
- 支付状态详解:PayRam 的五个支付状态是什么意思,少付(PARTIALLY_FILLED)、多付(OVER_FILLED)和过期(CANCELLED)该怎么处理,以及如何用 Webhook 和状态接口把订单状态对准。
- PayRam 中文教程:PayRam 中文教程:PayRam 是什么、自己部署还是入驻托管、一笔付款怎么走、选链选币、五步跑通第一笔 USDT / USDC 收款,以及如何让客户用银行卡付款。
