快速开始 —— 收款

三步即可从 AI agent 收款。你给结账定价；agent 支付；钱进你的账户。

1. 开通你的账户

AgentBank 是 Curless 旗下产品，账户和 key 都在你的 Curless 钱包里开通 —— 去申请 →。你会拿到一个 merchant id 和一个 API key；这就是唯一的凭据（不用自己接入收单机构，也没有 PCI）。

key 分两种模式：

测试 key —— 测试模式：不动真钱，所以你可以把整条流程（开一笔结账、agent 支付、订单出现）端到端跑通，再上正式。
正式 key —— 生产：真实扣款，结算进你的账户。

测试与正式完全隔离 —— 用测试 key 下的单，正式 key 看不到。

merchant id —— 标识你；出现在 URL 里；不是机密。
API key —— 机密；用于认证你后端发起的调用，并让你能读取自己的订单和余额。

2. 收款

挑一个和你所卖的东西匹配的方式。

卖商品 / 预订 / 服务
按 API / 工具调用收费

当一个 agent 想购买时，你的后端给出价格并打开一个结账；agent 支付；钱进你的账户。你依然是自己目录和定价的唯一信源 —— 不用向我们同步任何东西。

安装 SDK

npm install @curless/agentbank-merchant-sdk

打开一个结账 —— 这就是全部的接入

import { AgentbankMerchant } from '@curless/agentbank-merchant-sdk';

const agentbank = new AgentbankMerchant({
  baseUrl: 'https://mcp.curless.ai',
  apiKey: process.env.AGENTBANK_MERCHANT_TOKEN!, // your API key
  merchantId: process.env.AGENTBANK_MERCHANT_ID!,
});

// In your "an agent wants to buy" handler — YOU set the price from your catalog:
const checkout = await agentbank.checkout.openACP({
  currency: 'EUR',
  items: [
    { sku: 'resort-bali', name: 'Bali resort — 7 nights', quantity: 1, unitPrice: 192000 },
  ],
});

// Hand checkout.id to the buyer agent; it pays, the money lands in your account.
return { checkoutId: checkout.id };

agent (in Claude) ──▶ 你的店面 ──▶ 你的后端
                                              │  agentbank.checkout.openACP(…)  "这笔预订是 €1,920"
                                              ▼
                                          AgentBank ──▶ agent 支付 ──▶ 钱进你的账户

agent 自己完成支付（它自带资金）。你永远看不到银行卡、钱包或任何支付方式。

已经有一个 API 或一个 MCP 工具，想让每次调用都付费？把它包一层 —— 工具本身不变，只是变成了付费才能调用。

import { withPaywall, createHttpBackend, httpConsumedStore } from '@curless/agentbank-mcp-pay';

const baseUrl = 'https://mcp.curless.ai';
const apiKey = process.env.AGENTBANK_MERCHANT_TOKEN!; // your API key
const merchantId = 'your-merchant-id';

const paidTool = withPaywall(yourExistingToolHandler, {
  backend: createHttpBackend({ baseUrl, apiKey }),
  merchantId,
  price: 50, // minor units (e.g. cents)
  currency: 'USD',
  sku: 'premium-lookup',
  consumed: httpConsumedStore({ baseUrl, apiKey, merchantId }),
});

未付费的调用会返回一个“先付费”的提示；一旦 agent 支付，你的工具就运行，钱进你的账户。完全没有代码？npx @curless/cli init 会帮你生成脚手架。

3. 看着钱到账

直接在 Claude 里查看你的订单和实时余额 —— 添加 商户连接器 （URL 为 https://mcp.curless.ai/mcp，然后“登录”；不用粘贴任何密钥）。或者从你的后端读取：

# your orders, newest first
curl -H "Authorization: Bearer $AGENTBANK_MERCHANT_TOKEN" \
  https://mcp.curless.ai/v1/merchant/$MERCHANT_ID/orders

# your live balance per currency
curl -H "Authorization: Bearer $AGENTBANK_MERCHANT_TOKEN" \
  https://mcp.curless.ai/v1/merchant/$MERCHANT_ID/balance

你自动接受每一种协议

无论 agent 怎么付，你都能接受，且零协议代码：ACP、A2A、UCP、AP2、 Visa TAP、Skyfire。agent 用它会的那个来支付；每笔订单都会记录用了哪种协议。