跳转到主要内容
简而言之
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 密钥。如使用 Solana,请选择支持 Solana 的 facilitator。
3

以存款形式接收付款

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

在 Solana 上接收 x402 付款

在 Solana 上,智能体签署一笔 USDC 转账,由 facilitator 支付网络手续费。付款的到账方式相同:触发 deposit.success Webhook,senderAddress 为智能体的钱包,而不是支付手续费的 facilitator。
payTo 地址在收到第一笔 x402 付款之前需要有一个 USDC 代币账户,而 x402 付款无法创建该账户。Blockradar 地址会在首次收到 USDC 时获得其代币账户,因此请先向其发送任意金额的 USDC。仅在钱包上启用 USDC 并不会创建该账户。

MPP 工作原理

MPP(Machine Payments Protocol)是另一种按请求通过 HTTP 付费的开放协议。它的 EVM charge 与 x402 的结算方式相同:智能体签署一份转入您 recipient 地址的 EIP-3009 USDC 授权,您的服务器将其提交上链,USDC 直接从智能体的钱包转入该地址。请求头有所不同(WWW-Authenticate: Payment、Authorization: Payment 和 Payment-Receipt),但 Blockradar 记录的存款完全相同。

通过 MPP 收款

1

将 Blockradar 地址设为 recipient

MPP 将收款地址称为 recipient。请像设置 x402 的 payTo 一样使用 Blockradar 地址,Checkout 计划的规则同样适用。
2

通过 facilitator 结算

官方的 mppx 服务端通过 x402 facilitator 结算 EVM charge,因此您用于 x402 的 facilitator 在这里同样适用。
3

以存款形式接收付款

结算完成的转账会触发常规的 deposit.success Webhook,其中 senderAddress 为智能体的钱包。
JavaScript
您的服务器返回的 Payment-Receipt 中的 reference 是链上交易哈希,与存款的 hash 一致。上面关于归集的提示同样适用于 MPP 付款。

通过 Tempo 上的 MPP 收款

Tempo 上的 MPP charge 是一笔直接转入您 recipient 地址的稳定币转账,并附带一条将其与 challenge 关联的备注(memo)。该转账由智能体或您的服务器广播,因此无需任何 facilitator。
1

在您的 Tempo 钱包上启用该代币

您的钱包只会检测您已添加资产的存款。参见资产管理。
2

将 Blockradar Tempo 地址设为 recipient

使用您 Tempo 主钱包的地址或子地址(在 Checkout 计划下请使用主钱包地址),并将 currency 设为您要接收的代币:OUSD、USDC.e 或 USDT。代币地址见下方示例。USDT 在链上显示为 USDT0。
3

以存款形式接收付款

该转账会触发常规的 deposit.success Webhook,其中 senderAddress 为智能体的钱包。
JavaScript
如需代智能体支付交易手续费,请向 tempo.charge() 传入 feePayer。请使用保存在您自己服务器上的密钥,而不是您的 Blockradar 地址:手续费支付方会共同签署每笔 charge 交易,而 Blockradar 无法共同签署带手续费支付方的 Tempo 交易。

限制

  • 仅支持 EVM 网络和 Solana。 不支持其他网络上的付款。
  • Tempo 上的 MPP session 即将推出。 在此之前,暂不支持 MPP session 结算。
  • Circle Gateway 纳米支付会进入 Gateway 余额。 Circle 会将这类批量亚美分付款结算到卖方的 Gateway 余额,而不是以链上转账的形式转到 payTo,因此不会作为 Blockradar 存款到账,不在本指南范围内。

最佳实践

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

API 参考