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

# Agent 解决方案

> 让 Agent 连接 Clink Wallet，并通过 Browser Pay 在商户网站完成支付。

Clink 通过 MCP 向 Agent 提供用户支付卡和购买授权的访问能力。**Wallet Service** 管理这套支付关系；**Browser Pay** 为一次具体结账提供支付凭证，让 Agent 在商户网站完成购买。

## 卡组织合作与可用范围

<div className="not-prose my-4 w-fit p-8">
  <img src="https://mintcdn.com/clink/WOHh_9VfSF-k-jkf/images/partners/visa-blue.png?fit=max&auto=format&n=WOHh_9VfSF-k-jkf&q=85&s=dd416e18fa3d7f11748b4b2d9282ee53" alt="Visa" width={208} height={68} className="m-0 block h-auto w-24" noZoom data-path="images/partners/visa-blue.png" />
</div>

Clink 是 **Visa Intelligent Commerce（VIC）合作伙伴**。当前 Visa Agent 支付流程结合 Passkey 用户验证、购买授权和 Token 化支付凭证，让 Agent 在用户批准的范围内完成购买。VIC 的能力介绍见 [Visa 官方文档](https://developer.visa.com/capabilities/visa-intelligent-commerce/overview)。

具体卡片能否用于 Agent Pay，以当前钱包和工具返回为准。用户授权与支付限制的关系见 [Passkey 与购买授权](/cn/guides/agent/wallet_service#passkey-与购买授权)。

## 选择接入方式

<CardGroup cols={2}>
  <Card title="独立 Agent" icon="terminal" href="/cn/guides/agent/quickstart">
    在 Agent Host 中安装 Clink Skill、连接 MCP 并授权钱包。从可复制的安装 Prompt 开始。
  </Card>

  <Card title="Agent 平台" icon="cloud" href="/cn/guides/agent/platform_integration">
    通过 OAuth 连接每位用户，由平台调用 MCP。接收加密的 Browser Pay 凭证时，向 Clink 登记平台公钥。
  </Card>
</CardGroup>

两种接入方式使用同一套 Wallet Service 和 Browser Pay 工具，区别在于由谁管理 MCP 连接、用户 Token，以及需要时的凭证解密。

* **独立 Agent：** 按[快速接入](/cn/guides/agent/quickstart)完成连接和首次购买，再按 [Browser Pay](/cn/guides/agent/browser_pay)查阅支付步骤与恢复方式。
* **Agent 平台：** 从[平台接入](/cn/guides/agent/platform_integration)开始，按 [MCP 与 OAuth](/cn/guides/agent/mcp_integration)实现连接，再按 [Browser Pay](/cn/guides/agent/browser_pay)完成结账流程。

## 组件之间的关系

```mermaid theme={null}
%%{init: {"theme":"base","themeVariables":{"fontFamily":"inherit","fontSize":"14px","primaryColor":"#F7F7F7","primaryTextColor":"#161616","primaryBorderColor":"#E7E7E7","lineColor":"#71717A","edgeLabelBackground":"#FFFFFF"},"flowchart":{"nodeSpacing":40,"rankSpacing":38,"padding":14,"diagramPadding":12}}}%%
flowchart TD
  I[独立 Agent Host] --> M[Clink MCP]
  P[Agent 平台] --> M
  U[用户] -->|连接并授权| W[Clink Wallet]
  M --> W
  W --> C[支付卡]
  W --> A[购买授权]
  M -->|Browser Pay 凭证| B[Agent 浏览器]
  B -->|提交支付| S[商户结账页]
  B -->|观察到的结果| M
  classDef emphasis fill:#F8E1CC,stroke:#F8E1CC,color:#161616
  class M emphasis
```

用户连接钱包，并完成需要的绑卡或购买授权；Agent 操作商户结账页；Clink 返回支付凭证，并记录 Agent 上报的支付结果。

## Wallet Service

Wallet Service 支持：

* 查询用户当前的支付卡及 Agent Pay 就绪状态。
* 引导用户添加或管理支付卡，或修改默认卡。
* 创建、查询和管理购买指令（Purchase Instruction），即用户在指定限制内授予的消费授权。
* 跟踪用户操作，并继续对应的 Operation。

OAuth 授予工具访问权限；购买指令授权消费。完成 OAuth 本身不代表用户已授权购买。卡、购买指令与支付之间的关系见 [Wallet Service](/cn/guides/agent/wallet_service)。

## Browser Pay

商户结账页显示卡表单和最终总额后，调用 `get_credential`。需要用户添加支付卡或授权消费时，Clink 返回下一步操作。取得凭证后，Agent 填写商户卡表单、提交支付，再通过 `confirm_result` 上报观察到的结果。

| 返回的凭证 | 接入方处理方式 |
| :- | :- |
| `credential.card` | 直接使用返回的卡字段完成本次结账，无须额外解密。 |
| `credential.key` 与 `credential.payload` | 使用与已登记平台公钥配对的密钥解密信封，再使用解出的卡字段。 |

签发凭证不代表商户已收款。[Browser Pay 指南](/cn/guides/agent/browser_pay)覆盖完整流程，以及金额变化、凭证过期、支付结果未知等情况。

## 接入条件

| 条件 | 独立 Agent | Agent 平台 |
| :- | :- | :- |
| MCP 连接 | Host 支持 Streamable HTTP 与 OAuth | 平台实现 MCP 连接和用户 OAuth 流程 |
| 商户结账 | Agent 具备浏览器操作能力 | 平台提供浏览器操作能力 |
| 用户操作 | 用户在自己的设备完成登录、绑卡及需要的授权 | 平台将返回的操作链接展示给对应用户 |
| 加密凭证 | 仅在当前连接收到 `key` / `payload` 时需要处理 | 线下联系 Clink 配置平台公钥，使用[解密范例](/cn/guides/agent/browser_pay/decryption) |

卡是否可用、是否需要补充设置，以当前钱包和工具返回为准。选择支付流程时，读取已连接服务端发布的工具 schema 与当前规则；安装 Skill 不承载这些规则的固定副本。

## 其他商务能力

Clink MCP 也提供 Catalog 搜索与 UCP Checkout，分别使用对应工具搜索商品、准备并完成结账，以及查询订单和数字交付。需要使用这些能力时，参阅 [Catalog 与 UCP 接口参考](/cn/api-reference/mcp/commerce)。

## 继续阅读

* [独立 Agent 快速接入](/cn/guides/agent/quickstart)
* [Agent 平台接入](/cn/guides/agent/platform_integration)
* [Wallet Service 工具](/cn/api-reference/mcp/wallet)
* [Browser Pay 工具](/cn/api-reference/mcp/browser_pay)
* [Operation、规则与错误处理](/cn/api-reference/mcp/operations)


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