在终端里批量支付 OpenRouter 充值链接

OpenRouter 每一次加密货币充值都是一个独立的 Coinbase 付款链接。如果你替很多人充值，或者给自己的多个账户充值，可以用 ROZO Checkout 命令行在脚本里一次付完。用你平时的钱包和手里已有的币付款，不需要注册账户，也不需要 API key。

1. 安装

需要 Node 20.18 或更新版本，批量脚本还需要 jq。装一次，之后每次运行都不用重新下载。同一个命令行也可以作为 Claude Code 插件或 ClawHub skill 安装。

npm i -g @rozoai/checkout
rozo-checkout quote https://payments.coinbase.com/payment-links/pl_01YOURLINKID

2. 批量创建订单

在 links.txt 里每行放一个链接。循环会给每个链接建一个订单，并在 runs/batch.tsv 里写一行结果。

# links.txt：每行一个 Coinbase 链接
command -v jq >/dev/null || { echo "install jq first"; exit 1; }
mkdir -p runs
while IFS= read -r link || [ -n "$link" ]; do
  link="${link%$'\r'}"; link="${link%%\?*}"
  [ -n "$link" ] || continue
  id="${link##*/}"
  rozo-checkout pay "$link" --with usdt-solana --yes --json --no-watch \
    </dev/null > "runs/$id.json"
  code=$?
  row=$(jq -r --arg id "$id" --arg code "$code" '[$id, $code,
      (.order.rozoPaymentId // .error.details.body.rozoPaymentId // "-"),
      (if .success then "pending: pay before " + (.order.expiry.effectiveDeadlineIso // "?")
       else (.error.code // .send.error.code // "FAILED") end)] | @tsv' \
    "runs/$id.json" 2>/dev/null) || row="$id	$code	-	NO_OUTPUT"
  printf '%s\n' "$row" >> runs/batch.tsv
done < links.txt

• 不带 --send 时，建单不会动钱。结果行显示 pending，JSON 文件里是付款信息：deposit.receiverAddress 和 deposit.amount（Stellar 还有 deposit.receiverMemo），闪电则是 BOLT11 发票 deposit.lnInvoice。
• 每个订单建好后立刻付款，任何钱包或交易所提币都可以。金额和链必须和显示的一致。每个充值地址只能用一次，不要复用旧订单的地址。
• 以 order.expiry.effectiveDeadlineIso 为准，至少提前 order.expiry.marginMinutes 分钟停止付款。
• 同一个链接每次运行都用同一个 --with 币种。对未完成的链接再跑一次 pay 会拿回同一个订单，重试不会重复建单。

3. 确认每个链接都已到账

每个订单都用 rozoPaymentId 跟踪。receipt 只有在 Coinbase 本身确认发票已付时才返回 0。

rozo-checkout status <rozoPaymentId> --json | jq -r '.state, .escalate'

# 付成了吗？返回 0 = 已到账
rozo-checkout receipt <rozoPaymentId> --json

支持的币和链

用 --with 选一个，例如 usdt-solana、usdc-base、btc-lightning 或 sol。原生币只在报价列出时可用。不支持链上 BTC 和 Tron。完整列表见 AI 智能体页面。

费用

• ROZO 在 OpenRouter 发票金额之上收取 1% 服务费。建单之前，报价会列出发票金额和你要付的总额；具体的入金数额在建单后给出。
• 你实际转账的金额还包含该币种的跨链和网络费用，所以会比发票略高。原生币金额包含汇率价差。
• OpenRouter 会在发票里加上它自己的加密货币手续费，这笔费用归 OpenRouter，不归 ROZO。

限额

• 建单按 IP 每小时限速，有付款记录的调用方额度更高。触发时命令行返回 RATE_LIMITED：等一会儿，再继续处理还没到账的链接。当前数字见批量采购指南。
• 稳定币能付的单笔发票远大于原生币和 BTC 闪电，后两者单笔上限更低。计划大额发票前请先看批量采购指南里的限额。
• 可选的 --send 用本地私钥签名，单笔上限 $1,100。自己用钱包付款没有这个上限。

少付了怎么办

• 到账金额少于应付金额的订单不会自动完成。status 会显示 escalate: true，订单等我们这边人工处理。
• 不要再付一次，也不要给这个链接新建订单。把链接、rozoPaymentId 和所有交易哈希发到 hi@rozo.ai，我们人工处理。
• 如果订单过期而你没有付过钱，对同一个链接再跑一次同样的 pay。如果你往旧地址转过钱，请先联系我们。