为什么 AI 代理需要加密货币?
代理支付流程
收款(代理获得支付)
代理通过创建收款订单来接收加密支付。这是最常见的流程——用户或其他代理将资金发送到代理生成的充值地址。ORDER_SUCCESS Webhook 以释放服务:
付款(代理支付)
代理向外部地址发起付款——支付计算费用、质押或与其他代理结算:代理间支付
两个自主代理可以直接交易:自主代理架构
关键设计考量
密钥管理
商家令牌和 API 密钥必须在运行时对代理可用,且不能硬编码:幂等性
代理可能会重试失败的请求。使用orderId 字段作为幂等键——在 createCollection 或 createPayout 调用中使用相同的 orderId 会返回现有订单,而不会创建重复订单。
Webhook 可靠性
如果 Webhook 丢失,代理应使用轮询回退(getOrderStatus)。每 3 秒轮询一次直到 SUCCESS、EXPIRED 或 FAILED:
余额管理
在创建付款前,检查网关热钱包余额:应用场景
开始使用
- 通过 Docker Compose 部署 XPayLabs
- 安装 Node.js SDK 或直接调用 REST API
- 使用商家令牌和 API 密钥配置代理的环境
- 为
ORDER_SUCCESS事件创建 Webhook 端点 - 开始通过编程方式创建收款和付款订单

