> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 接收智能体支付

> 以稳定币接收 AI 智能体的付款，付款会作为普通存款到账您的 Blockradar 钱包

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

## 支持的协议

| 协议 | 网络和代币 |
| - | - |
| [x402](https://www.x402.org) | EVM 链，USDC（EIP-3009） |

<Tip>
  您在构建付款的智能体？请参阅[发起智能体支付](/zh/use-cases/make-agent-payments)。
</Tip>

## 前提条件

<Steps>
  <Step title="API 密钥">
    从 [Blockradar 控制台](https://dashboard.blockradar.co) 获取您的 API 密钥。进入 **Developers** 生成密钥。
  </Step>

  <Step title="EVM 主钱包">
    在控制台中，于您收费所在的链（例如 Base）上创建主钱包（参见[创建主钱包](/zh/guides/create-master-wallet)）。
  </Step>

  <Step title="启用 USDC">
    在钱包上启用 USDC。您的钱包只会检测您已添加资产的存款。参见[资产管理](/zh/use-cases/asset-management)。
  </Step>

  <Step title="Webhook URL">
    在控制台的 **Developers → Webhooks** 中配置 Webhook 端点，以便在每笔付款到账时收到通知。
  </Step>
</Steps>

***

## x402 工作原理

[x402](https://www.x402.org) 是一种开放协议，允许 API 按请求收费。您的 API 以 HTTP `402 Payment Required` 和价格响应未付款的请求，智能体随后携带已签名的 USDC 授权重试请求，由 **facilitator** 验证该授权并将转账提交上链，同时支付 Gas。USDC 直接从智能体的钱包转入您的 `payTo` 地址。

您负责运行 x402 服务端中间件并选择 facilitator。Blockradar 是资金到账的地方。

## 通过 x402 收款

<Steps>
  <Step title="将 Blockradar 地址设为 payTo">
    使用主钱包的地址，或按产品或客户[生成子地址](/zh/api-reference/addresses/generate-address)并附加 `metadata`，使每笔付款都能对应到所购买的内容。在 [Checkout 计划](/zh/use-cases/checkout#checkout-计划)下，子地址不可用，请使用主钱包地址。
  </Step>

  <Step title="通过 facilitator 结算">
    将您的 x402 中间件指向支持您所用网络的 facilitator。[Circle's Facilitator Service](https://developers.circle.com/facilitator-service) 在 Arc、Base 和 Polygon PoS 上结算 USDC。配置时请使用 Circle API 密钥。
  </Step>

  <Step title="以存款形式接收付款">
    当 facilitator 完成结算后，转入您 `payTo` 地址的 USDC 会像其他存款一样被检测到，并触发常规的 [`deposit.success` Webhook](/zh/use-cases/deposit-stablecoins#webhook-payload)。
  </Step>
</Steps>

在 Webhook 中，`senderAddress` 是**买方的钱包**，而不是提交交易的 facilitator，因此您可以看到付款方是谁。`hash` 与您的服务器返回的 `PAYMENT-RESPONSE` 中的 `transaction` 一致。

<Tip>
  x402 付款通常只有一美分甚至更少。如果 `payTo` 是开启自动归集的子地址，每笔付款都会被单独归集到主钱包。请为 USDC 设置[归集阈值](/zh/use-cases/asset-management)，或将主钱包的地址用作 `payTo`，以免为低于归集手续费的金额支付归集费用。
</Tip>

***

## x402 的限制

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

***

## 最佳实践

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

***

## API 参考

| 端点 | 说明 |
| - | - |
| [Generate Address](/zh/api-reference/addresses/generate-address) | 创建专用的 `payTo` 地址 |
| [Update Address](/zh/api-reference/addresses/update-address) | 为地址开启或关闭自动归集 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.