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

RugWard Pay

账单、收款链接和测试付款

在后台创建账单，分享可重复使用的收款链接和按钮，在测试网上免费体验完整的收银流程，并处理无法匹配的付款。

本页内容

创建账单#

在后台填写 New invoice，然后点击 Create invoice。你会得到一个发给买家的收银链接（https://rugward.com/pay/i/<id>）。

新建账单表单
1 美元金额 · 2 有效期 · 3 你的订单号 · 4 返回网址
字段规则说明
① Amount (USD)1 美元至 50,000 美元，最多 2 位小数（25 或 25.50）买家以其选择的币种支付等值金额。
② Expires after后台可选 30 分钟、1 小时（默认）、3 小时、1 天或 7 天；通过 API 可设 15 分钟至 7 天过期后，收银页面显示 "Do not send anything"，且无法再锁定新汇率。
③ Order id（可选）最多 64 个字符：字母、数字以及 . _ - : # /你自己的参考编号；会在 API 和 Webhook 中返回。
④ Return URL（可选）完整的 https:// 地址仅在账单支付后才向买家显示，形式为 "Return to <你的网站>" 按钮。
Description（可选）最多 200 个字符向买家显示，例如 "1 × T 恤，M 码"。

买家在收银页面上选择币种。汇率从那一刻起锁定 30 分钟（而不是从账单创建时起），因此较长的账单有效期不会让你承受价格波动。

只有在后台（或 invoice.paid Webhook）显示 Paid 后才发货。 买家到达你的返回网址并不能证明已付款：任何人都可以打开一个网址。

账单列表和详情#

Invoices 显示你最近的账单，包括日期、金额、订单号和状态。Details 打开某张账单：报价（币种、金额、汇率、地址）、链上看到的每笔付款及其确认数和区块浏览器链接，以及 Open checkout、Payment proof（已支付账单）和 Cancel invoice 按钮。

账单列表
账单列表：一张真实账单和一张 TEST 账单

你会看到的状态标签：

标签API 状态
Awaiting payment（等待付款）open
Payment detected, confirming（已检测到付款，确认中）pending
Paid（已支付）paid
Paid (more than requested)（多付）overpaid
Underpaid（少付）underpaid
Paid after expiry（过期后支付）late
Expired（已过期）expired
Canceled（已取消）canceled

每种状态的含义及处理方式：状态、确认和证明。

取消账单#

当你的账单处于 open 状态且尚未看到任何付款时，你可以取消它。收银页面随后会告诉买家："The merchant canceled this invoice. Do not send anything to it." Webhook：invoice.canceled。已有付款在途的账单无法取消（409）。

买家看到的已取消账单
你取消后买家看到的内容

收款链接和按钮#

收款链接是一个固定价格的可重复使用链接：一件商品、一笔捐款、一个月度会员。每个点击 Pay with crypto 的买家都会获得一张属于自己的新账单（有效期 60 分钟），因此付款永远不会混淆。

后台中的收款链接
创建链接、预览买家卡片、复制链接或按钮 HTML
  1. 输入美元金额、描述和可选的返回网址，然后点击 Create link。
  2. 后台显示买家视图（与买家看到的完全一致）、链接 https://rugward.com/pay/l/<id> 以及使用次数。
  3. 点击 Copy link 在聊天、邮件或社交媒体中分享，或点击 Copy button HTML 在你的网站上放置 "Pay with crypto" 按钮。
  4. Turn off 会停用该链接。已通过它创建的账单不受影响。

该按钮是一个普通的 HTML 链接。它不加载任何脚本，也不设置任何 cookie：

html
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
   style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
收款链接的买家视图
rugward.com/pay/l/…：买家点击 Pay with crypto 并获得自己的账单

须知：

  • 通过链接创建的账单带有订单号 link:<链接 id 的前 8 个字符>，便于你在列表、API 和 Webhook 中区分。
  • 限制：每个商户最多 100 个有效链接；每个链接每小时最多创建 100 张账单（保护你的每小时账单额度不被滥用）。必要时，打开链接会受到 Cloudflare Turnstile 保护。

测试账单（免费，Sepolia 测试网）#

在后台打开 Test invoice (Sepolia testnet)，无需真钱即可体验完整的收银流程。买家通过部署在 Sepolia 上的 RugWard Pay 分账合约，使用 Sepolia 测试 ETH 或 Circle 的 Sepolia 测试 USDC 付款；该合约将 99.5% 发送到收款地址，0.5% 发送到 RugWard 费用钱包，与 Base 上完全相同。

TEST 账单的收银页面
TEST 账单在各处均有标记，且只接受 Sepolia 测试币
  • 金额：1 美元至 100 美元。可选的测试收款地址（一个 EVM 地址）；否则使用你的 EVM 地址。
  • 测试币没有价值，且免费获取：从水龙头领取 Sepolia ETH（例如 Google Cloud 的 Sepolia 水龙头），从 Circle 水龙头领取测试 USDC（选择 Ethereum Sepolia）。
  • 测试账单在收银页面、列表和证明中都标有 TEST；它们从不调用你的 Webhook，且无法用 API 密钥创建，因此测试永远不会导致真实订单发货。

无法匹配的付款#

有时一笔转账到达了你的地址，但与任何账单都不完全匹配：金额错误、在过期很久之后才发送，或与订单无关的转账。RugWard 从不自动将这些标记为已支付。如果存在这类付款，后台会显示一个 Unmatched payments 框，列出金额、网络、交易链接以及看到该付款时正在检查的账单。

处理方式：打开该交易，联系买家，由你自行处理（发货，或从你的钱包退回款项）。然后点击 Dismiss。

最后更新: 2026年10月30日

账单、收款链接和测试付款 · RugWard 文档 | RugWard