Skip to main content
简而言之
AI 智能体可以通过开放的智能体支付协议,使用稳定币按请求为 API 和数据付费。如果您向智能体出售服务,可以使用 Blockradar 地址接收这些付款。付款会作为普通存款到账,触发常规的 Webhook,并以付款智能体的钱包作为发送方,因此在 Blockradar 一侧无需任何新的集成。

支持的协议

您在构建付款的智能体?请参阅发起智能体支付。

前提条件

1

API 密钥

从 Blockradar 控制台 获取您的 API 密钥。进入 Developers 生成密钥。
2

EVM 主钱包

在控制台中,于您收费所在的链(例如 Base)上创建主钱包(参见创建主钱包)。
3

启用 USDC

在钱包上启用 USDC。您的钱包只会检测您已添加资产的存款。参见资产管理。
4

Webhook URL

在控制台的 Developers → Webhooks 中配置 Webhook 端点,以便在每笔付款到账时收到通知。

x402 工作原理

x402 是一种开放协议,允许 API 按请求收费。您的 API 以 HTTP 402 Payment Required 和价格响应未付款的请求,智能体随后携带已签名的 USDC 授权重试请求,由 facilitator 验证该授权并将转账提交上链,同时支付 Gas。USDC 直接从智能体的钱包转入您的 payTo 地址。 您负责运行 x402 服务端中间件并选择 facilitator。Blockradar 是资金到账的地方。

通过 x402 收款

1

将 Blockradar 地址设为 payTo

使用主钱包的地址,或按产品或客户生成子地址并附加 metadata,使每笔付款都能对应到所购买的内容。在 Checkout 计划下,子地址不可用,请使用主钱包地址。
2

通过 facilitator 结算

将您的 x402 中间件指向支持您所用网络的 facilitator。Circle’s Facilitator Service 在 Arc、Base 和 Polygon PoS 上结算 USDC。配置时请使用 Circle API 密钥。
3

以存款形式接收付款

当 facilitator 完成结算后,转入您 payTo 地址的 USDC 会像其他存款一样被检测到,并触发常规的 deposit.success Webhook。
在 Webhook 中,senderAddress 是买方的钱包,而不是提交交易的 facilitator,因此您可以看到付款方是谁。hash 与您的服务器返回的 PAYMENT-RESPONSE 中的 transaction 一致。
x402 付款通常只有一美分甚至更少。如果 payTo 是开启自动归集的子地址,每笔付款都会被单独归集到主钱包。请为 USDC 设置归集阈值,或将主钱包的地址用作 payTo,以免为低于归集手续费的金额支付归集费用。

x402 的限制

  • EVM 网络。 在 Solana 等非 EVM 的 x402 网络上的付款尚未在 Blockradar 地址上测试。
  • 不支持 Circle Gateway 纳米支付。 Circle 的批量亚美分付款选项尚未在 Blockradar 钱包上测试。

最佳实践

  • 每个产品或客户一个地址。 为每个付费资源或每个买方账户生成一个子地址,并使用 metadata 标记,使每个存款 Webhook 无需查询即可告诉您所购买的内容。
  • 按 hash 对账。 将每个 deposit.success Webhook 的 hash 与您的服务器在 PAYMENT-RESPONSE 中返回的 transaction 进行匹配。
  • 先在测试网上测试。 将您的中间件指向测试网,例如 Base Sepolia(eip155:84532),并在上线前使用来自水龙头的测试网 USDC 向自己付款。

API 参考