中文

如何让你的 AI Agent 收取 USDC 付款

Shawn Muggle

你的 AI agent 已经能替你写代码、回工单、接活。它通常做不到的,是收钱。许多支付流程仍然依赖浏览器会话、基于邮箱的账户和需要人操作的后台。

Rozo 的 Agent Merchant API 拿掉了这层假设。一个 EVM EOA 用一次钱包签名即可注册为商户;访问获批后,再用一次全新签名换取仅限 Orders 权限的 API key,用于开票和读取付款状态。资金以 USDC 结算到 Base 上的签名地址,agent 可以轮询 API 直到结算到达 payout_completed。本文带你走完整条链路。

用加密货币支付 OpenRouter 的步骤:复制你的 OpenRouter payment link,粘贴到 ROZO Checkout,选一条链,然后付款。
每种方式的第一步都一样:把你的 OpenRouter payment link 或 payment ID 粘贴到 ROZO Checkout。

Agent 实际拿到什么

五步闭环

  1. 取 challenge:GET /account-nonce?chain=evm&address=$ADDRESS&intent=merchant_onboard。服务端返回要签的确切消息;匿名 nonce 会被拒绝。
  2. 本地签名并注册:POST /account-onboard,带上地址、签名和 nonce。私钥永远不离开 agent 的运行环境。
  3. 申请访问并签发受限凭证:用钱包 session 调用 POST /account-credentials/request,每天重发同一请求不超过几次以查询状态。获批后,签一条全新的 credential_issue challenge,再调用 POST /account-credentials 并传 scope "orders"。签出的凭证是 Orders 权限;Orders 凭证无法创建 Admin key。
  4. 开发票:POST /payment-api,带上稳定的 orderId、Idempotency-Key、展示信息和 USDC 金额。不要传 destination。网络失败后,用同一 orderId 和幂等键重试。
  5. 轮询付款状态:用 Orders key 和稳定的 orderId 轮询直到 payout_completed。即使 webhook 或邮件投递失败,也应以返回的付款状态为准。若响应包含 payout 交易哈希,你还可以在 Base 上额外核验。

完整的机器可读契约在 https://partners.rozo.ai/llms.txt——它就是写来直接粘贴给 agent 的。

为什么权限刻意收窄

给自主运行的 agent 一把支付凭证,正是最该多疑的地方。API 的设计目标是让泄露一把 agent key 的破坏半径尽量小:

如何获得访问权(alpha)

凭证计划在 alpha 期间采用邀请制。完成注册后,agent 调用 POST /account-credentials/request,并每天重发同一请求不超过几次以查询状态。审批由 Rozo 侧的人做决定,但全程不需要邮件或私信。当前的凭证与开票闭环支持在 Base 上以 USDC 结算的 EVM EOA。Solana 和 Stellar 的 EOA 可以注册并在各自签名地址所在链上以 USDC 结算,但不在本凭证闭环内。

本 alpha 不支持 EVM 合约钱包,且纯钱包账户没有找回路径:签名私钥一旦丢失,Rozo 无法恢复该商户,也不提供人工过户。

从 https://partners.rozo.ai/agent 开始。

常见问题

我的 AI agent 需要邮箱或浏览器才能收 USDC 吗?
核心流程不需要邮箱也不需要浏览器。注册和凭证管理动作需要本地钱包签名;开票和读取付款状态是普通的 HTTPS API 调用。
资金由谁保管?
结算完成后,USDC 会交付到注册时签名的那个 Base 地址。API 不允许 Orders key 更改这个目的地址。
泄露的 agent API key 实际能做什么?
在当前契约下,它能为那一个账户开发票、读付款状态。它改不了收款地址、铸不了其他 key、碰不到管理功能。发现泄露请立即用新的钱包签名撤销。
客户可以从哪些链付款?
请以生成的付款链接上当前可用的支付选项为准——API 契约并不枚举客户侧的链和资产。本 alpha 阶段的 EVM 商户,结算为 Base 上的 USDC。
现在就能用吗?
能,目前是面向 EVM EOA 钱包的邀请制 alpha。agent 通过 API 自行申请访问,由 Rozo 侧的人批准。

用你手上已有的加密货币支付 OpenRouter

粘贴你的 OpenRouter payment link,选一条链,然后在钱包里确认。

打开 ROZO Checkout

用你手上已有的加密货币支付 OpenRouter

打开 ROZO Checkout