跳转到主要内容
AI 代理可以使用 XPayLabs 自主发送和接收稳定币支付。代理调用 REST API 创建收款订单和发起付款,监听 Webhook 事件,并管理余额——零网关费用,资金完全自托管。

为什么 AI 代理需要加密货币?

挑战XPayLabs 解决方案
代理需要可编程货币REST API 支持 createCollection/createPayout——代理直接调用端点
无需人工参与审批使用环境变量中存储的密钥自动签名
跨境代理间支付TRON、EVM 和 SUI 上的稳定币数秒内完成结算
微交易零网关费用——仅区块链 gas 费用(0.010.01–0.50)
需自托管非托管——密钥保留在您的 Docker 容器中

代理支付流程

收款(代理获得支付)

代理通过创建收款订单来接收加密支付。这是最常见的流程——用户或其他代理将资金发送到代理生成的充值地址。
代理随后监听 ORDER_SUCCESS Webhook 以释放服务:

付款(代理支付)

代理向外部地址发起付款——支付计算费用、质押或与其他代理结算:

代理间支付

两个自主代理可以直接交易:

自主代理架构

关键设计考量

密钥管理

商家令牌和 API 密钥必须在运行时对代理可用,且不能硬编码:

幂等性

代理可能会重试失败的请求。使用 orderId 字段作为幂等键——在 createCollectioncreatePayout 调用中使用相同的 orderId 会返回现有订单,而不会创建重复订单。

Webhook 可靠性

如果 Webhook 丢失,代理应使用轮询回退(getOrderStatus)。每 3 秒轮询一次直到 SUCCESSEXPIREDFAILED

余额管理

在创建付款前,检查网关热钱包余额:
对于 EVM 链,还需确保热钱包有足够的原生 gas 代币(ETH、BNB、MATIC、AVAX)来支付交易费用。

应用场景

场景流程示例
API 按次付费访问代理创建收款→用户支付→Webhook 解锁端点LLM 推理 API
计算资源市场Agent A 通过付款向 Agent B 支付 GPU 时间分布式 ML 训练
自主联盟营销联盟代理接收收款 Webhook,向推荐人分配付款推荐计划
代理间结算代理钱包之间的定期批量付款跨代理记账
微支付流频繁的小额收款实时数据流

开始使用

  1. 通过 Docker Compose 部署 XPayLabs
  2. 安装 Node.js SDK 或直接调用 REST API
  3. 使用商家令牌和 API 密钥配置代理的环境
  4. ORDER_SUCCESS 事件创建 Webhook 端点
  5. 开始通过编程方式创建收款和付款订单
对于代理间支付,两个代理可以共享同一个 XPayLabs 网关实例——或者运行各自的独立实例以实现完全隔离。
最后修改于 2026年6月26日