买家付款,你就收到款,同一笔交易。
没有结算周期,不用申请提现,也没有任何人能冻结的余额。钱从买家的钱包出来,直接进入你的钱包。
这是什么服务
UnifiWallet Payments 是一个加密货币支付网关。商店请我们创建一笔支付,我们向买家展示收银页面,买家的钱直接进入商店自己的钱包,随后我们通知商店款项已经到账。
这正是它与普通支付网关的根本差别:我们这里没有你的余额,没有结算周期,也没有任何我们能冻结的东西。我们的手续费在付款给你的那同一笔交易里扣除。
你需要知道的几件事
- 你的钱不在我们手里。买家的交易直接付款到你的钱包地址。
- 网络手续费由我们垫付并从金额中扣除,你无需持有链上原生币。
- 卖家是你,不是我们。买卖合同存在于你和你的客户之间。
- 退款由你自己发出。我们记录应退金额、构造交易,并在链上核验。
- 订单可以先冻结:资金留在智能合约里,发货时再由你取走。
没有人能撤销的事
区块链上已确认的交易无法撤回。如果钱转到了错误的地址、你丢失了钱包私钥、或者代币发行方冻结了你的地址,我们都无能为力——因为那笔钱从来没有经过我们的手。
让我们无法冻结你资金的那个特性,同样让我们无法把它追回。这就是这套架构所做的取舍。
常见问题
我什么时候能收到钱?
买家付款的当下。没有结算延迟,因为根本就没有结算这一步:买家签名的那笔交易本身就是付给你的款。不过发货请等到状态变为 completed,而不是 settled。
费用是多少?
每笔支付按比例收取,在同一笔交易中扣除,另加网络手续费。没有月费,没有提现费,也没有退款罚金。
网络手续费由谁承担?
由你选择。默认加在买家的总额上,并作为单独一项展示给买家;你也可以自己承担,那样它会从你的收款中扣除。
买家需要持有 ETH 吗?
不需要。买家只负责签名,交易由我们提交。只持有 USDC 的人也能付款——而这正是最常见的情况。
如果我丢失了钱包的访问权限怎么办?
这笔钱就没了,我们帮不上忙,因为它从来不在我们手里。请选择一个五年后你依然能打开的钱包。
为什么新的结算地址不能立刻生效?
为了防住一种具体的情形:有人盗取了你的登录凭据,在深夜把结算地址改掉。等待期、发给所有账户所有者的邮件,以及必须用该钱包签名,是这条路上三道各自独立的门槛。
退款是怎么运作的?
由你发出。我们记录应退金额并设定期限,构造出精确的交易,并在链上核验它确实到账。因为你的钱不在我们手里,我们无法代你退款——也正因如此,没有任何人能强迫我们这么做。
我能先冻结订单、之后再收款吗?
可以,在已部署冻结合约的链上。买家的钱会进入一个合约而不是你的钱包;发货时你把它取走,可以全额也可以部分,或者整笔释放回去。释放只需付网络手续费。
最长能冻结多久?
默认七天——与银行卡授权的时长相同——平台允许时最长三十天。超期之后,买家不需要我们、也不需要你,就能自行取回他的钱。
如果买家在过期之后才付款呢?
钱依然会到你手上,我们会通过 payment.late_settled 事件通知你。让一笔支付过期并不能阻止买家的钱包。要发货还是要退款,由你决定。
如果买家转错了币种呢?
我们会记录下来、通知你,并在该笔支付过期后退回买家的退款地址。它绝不会被算作付款。
如果我的 API 密钥泄露了呢?
在面板里吊销它,它会立刻失效。一把密钥不能创建另一把密钥、不能添加结算地址、也不能更改付款去向——这些都需要真人登录面板并重新输入密码。
UnifiWallet 能冻结我的资金吗?
不能——这不是一句承诺,而是架构本身的性质。钱在你的钱包里,我们既没有它的私钥,也没有任何能够动它的合约。
我怎样才能确认一笔款项真的付了?
通过 webhook,或者重新从 API 读取这笔支付。绝不要以买家的浏览器跳回你的成功页面为准:访问一个网址什么也证明不了。
我可以不用真钱来测试吗?
可以。测试密钥运行的是同一套状态机,并发送真实的 webhook,包括那些棘手的情形:金额不足、超时过期、以及链重组。测试密钥接触不到任何真实数据。
你们会保存买家的哪些信息?
尽可能少:一个可选的引用编号、国家、付款的钱包地址;只有在你要求发送收据时才会有邮箱地址,而且是加密存储的。
如果 UnifiWallet 明天不存在了呢?
已经在你钱包里的钱仍然在那里;我们从来就不在它的路径上。合约没有所有者:任何人都可以触发一笔存款的完成,买家也能自行取回已过期的冻结款。消失的是服务,不是钱。
技术文档
面向开发者的完整文档——API 参考、webhook、代码示例和接入指南—— 为英文。这是刻意的选择:字段名一旦被翻译就不再有效,而关于不可逆资金的警告若被翻译冲淡,比没有警告更糟。