Skip to content
RugWard
RugWard 文档
🌐 简体中文 ▾
☰ 菜单

RugWard Pay

安全、常见问题与故障排查

RugWard Pay 如何保护商户和买家、常见问题解答，以及商户和买家最常遇到的问题的解决方法。

本页内容

安全模型#

关于你的资金

  • 非托管。 付款从买家的钱包直接进入你的钱包。RugWard 没有你资金的密钥，也没有可丢失的余额。
  • 每张账单锁定地址。 每张账单在创建时都会保存一份你的收款地址副本。之后修改地址绝不会改变已开启账单的收款去向。
  • 只有钱包签名才能修改地址。 设置、API 密钥和 Webhook 都需要钱包登录会话。被盗的 API 密钥可以创建或取消账单，但无法更改资金去向。
  • 拒绝不安全的地址。 代币合约、Solana 代币 mint、程序及程序拥有的账户、Monero 集成地址以及受制裁的 EVM 地址都无法保存。智能合约钱包仅在该钱包实际存在的网络上被接受。
  • 固定的代币合约。 USDC/USDT 合约地址由 RugWard 硬编码，因此假代币永远无法支付账单。

关于付款检测

  • 价格取自多个独立来源的中位数（至少两个来源的差异须在 2% 以内）；买家的浏览器从不发送价格。
  • 一笔交易只能支付一张账单；报价之前已上链的交易不能支付它；粘贴的交易必须与唯一金额完全一致，或携带报价的引用。
  • 只有达到所需确认数后状态才会改变。不完全匹配的付款会显示为 unmatched（未匹配），且绝不会自动入账。

关于你的账户

  • 登录是一次免费的消息签名，使用一次性 nonce，有效期 10 分钟，并绑定 rugward.com。支持智能钱包（ERC-1271 / ERC-6492）。
  • 会话 cookie 为 HttpOnly、Secure、SameSite=Strict，有效期 7 天；Sign out 会结束会话。
  • API 密钥以 SHA-256 哈希形式存储；Webhook 密钥和可选的 Monero 查看密钥加密存储。密钥和 Webhook 密钥都不会再次显示。
  • 控制台请求必须来自 rugward.com 本身（跨站请求会被拒绝），公开的结账操作受 Cloudflare Turnstile 和频率限制保护。

RugWard 绝不会做的事

  • 绝不索要助记词或私钥，也绝不要求买家"验证"、"同步"或"解锁"钱包。
  • 绝不请求无限额代币授权：Base 结账只为分账合约授权恰好等于账单的金额。

RugWard Pay 已由 RugWard 内部审查。尚未经过独立机构审查。

常见问题#

我需要注册或通过 KYC 吗？#

你使用钱包登录。RugWard 不要求任何证件。你必须接受商户条款，并遵守适用于你和你买家的法律。

可以用哪些钱包登录？#

RugWard 钱包连接器支持的任意 EVM 钱包（MetaMask、Trust、Rabby、Coinbase Wallet 等；智能合约钱包通过 ERC-1271 / ERC-6492），或能签名消息的 Solana 钱包（Phantom、Solflare 或 Backpack）。参见商户设置。

能收到我没有启用的币种吗？#

不能。买家只能看到你已启用且设置了地址的币种。持有其他币种的买家可以先在自己的钱包中兑换成你接受的币种。

是否会自动兑换成稳定币？#

不会。你收到的正是买家支付的那种币。如有需要可稍后自行兑换，例如使用 RugWard Swap。

费用是多少？#

Base 上的 ETH 和 USDC 收取 0.5%（链上拆分）；上线优惠期间其他所有网络均为 0%。买家支付通常的网络手续费。参见费用。

RugWard 能给买家退款或撤销付款吗？#

不能。资金在你的钱包里；只有你能退回。参见退款。

可以用一个地址收多张账单吗？#

可以。唯一金额（Bitcoin、EVM 代币、Solana）、Solana Pay 引用、Base 分账合约引用以及 Monero 交易证明会把各笔付款区分开。出于隐私考虑，你仍可选择为每项业务使用单独的钱包。

为什么买家要支付一个"零头"金额？#

最后几位数字是识别该账单的唯一标记（几聪或几分之一美分）。买家额外支付这一极小金额；账单金额会向上取整，确保你不会少收。

发货前如何确认付款真实？#

等待控制台显示 Paid 或收到经过验证的 invoice.paid Webhook，然后（对于服务器集成）用 API 重新读取账单。绝不要依赖返回 URL 或买家提供的截图。

能否不提供查看密钥就接受 Monero？#

可以。默认情况下，买家使用交易 id 和交易密钥证明付款。保存查看密钥（加密存储）只是让买家更方便；它能看到入账付款，但永远无法花费。

测试账单需要花钱吗？#

不需要。它们使用 Sepolia 测试网币，免费且没有价值，并且从不发送 Webhook。

RugWard Pay 在所有地区都可用吗？#

不是。来自某些地区的请求会被阻止（HTTP 451），且该服务不面向受制裁司法辖区的用户。

商户故障排查#

问题解决方法
"Accept the RugWard Pay merchant terms first (Settings)"在 Settings 中勾选条款并保存。
"Add at least one receiving address and enable a coin first"至少为一个系列（Bitcoin、EVM、Solana 或 Monero）保存地址，并启用该系列中的一种币。
地址被拒绝它是代币合约、mint/程序、Monero 集成地址、未在该网络部署的智能钱包，或未通过制裁筛查。请使用普通钱包地址。
"Too many requests"触发了每 IP 限制（整个 Pay 约每分钟 20 次）。请等待一分钟；使用 Webhook 代替轮询。
"Invoice limit reached (500 per hour)"请等待，或对重复购买复用支付链接。
使用 API 密钥返回 401密钥已被撤销或输入错误。密钥只显示一次：请创建新密钥。
403 "Cross-site request refused"你从其他网站调用了控制台端点，或从浏览器发送了密钥。请从你的服务器调用 API。
账单显示 Underpaid买家付少了。请（在 RugWard 之外）要求补足差额或退款。
钱包里有付款但账单未支付查看 Unmatched payments；对于 Base 报价，买家很可能直接转账而没有使用按钮。

买家故障排查#

提示信息含义
"The price is not available from enough independent sources right now"价格来源不一致或无法访问。请选择其他币种，或一分钟后重试。
"Too many coin changes on this invoice"报价超过 8 次。请向商户索要新账单。
"This transaction was mined before the invoice was quoted"粘贴的交易早于报价。
"This transaction sent X, but this invoice needs exactly Y"金额不同。请带上交易 id 联系商户。
"This transaction was already used to pay a different invoice"一笔付款只能支付一张账单。
"This transaction is not a RugWard Pay splitter payment for this invoice"对于 Base 报价，请使用结账页面上的按钮付款。
"The RugWard Pay splitter code on this network does not match the reviewed build"安全检查阻止了付款。没有发送任何资金。请选择其他币种并报告此问题。
状态一直是 "Payment detected, confirming"正在等待确认（Base 30 个区块、Ethereum 12、Bitcoin 1、Monero 10……）。

最后更新: 2026年10月30日

安全、常见问题与故障排查 · RugWard 文档 | RugWard