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

# Moove 代理支付

> 一条提示词就能搭出加密结账——把 Moove Agent 技能文件下载进你的 AI 编码工具，让它替你集成已上线的支付链接 API。

把一条提示词粘贴进你的 AI 编码工具，就能在自己的网站上收加密货币。

<Info>
  **网页。** 介绍页面、仪表板和下载都在网页上。没有手机端的对应界面。
</Info>

## Moove 代理支付是什么？

Moove 代理支付是一个 **技能文件**——一份你的 AI 编码工具会读取的指令文件——它教会那个工具如何集成已上线的 moove.xyz 支付链接 API。

你把它下载下来，丢进你的工具里，然后描述你想要什么。工具会针对真实的 API 写出集成代码。

<Note>
  这个技能文件从不移动资金。它读文档、写代码。每一笔付款仍然在链上结算到 API 密钥所属账户的钱包，而密钥本身无法把资金改道到别处。
</Note>

## 三步怎么集成？

<Steps>
  <Step title="下载技能文件或某个插件">
    一个 `skill.md` 在哪里都能用。插件只是把同一个文件重新打包到你那款工具会去找的位置。
  </Step>

  <Step title="放进一条提示词">
    使用 [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments) 上现成的提示词，或者自己写一条。
  </Step>

  <Step title="构建并部署">
    你的工具会搭出结账。它创建的密钥、链接和交易，在 [Moove 管理](/zh-hans/manage/overview)中管理。
  </Step>
</Steps>

## 有哪五个插件？

Moove Agent Skills 遵循一个开放标准，所以同一个文件能在 40 多个 AI 模型上运行。插件只是方便，不是必需。

| 工具                 | 插件安装什么                            |
| ------------------ | --------------------------------- |
| **Claude Code**    | 一份插件清单加上技能文件                      |
| **Codex**          | `AGENTS.md`                       |
| **Gemini CLI**     | `GEMINI.md`                       |
| **Cursor**         | `.cursor/rules/` 下的一个规则文件         |
| **GitHub Copilot** | `.github/copilot-instructions.md` |

从 [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments) 下载其中任何一个。

<Tip>
  这五个都不用？下载纯粹的 `skill.md`，把它放到你的工具读取指令的任何地方。是同一个文件。
</Tip>

## 开始之前

<Steps>
  <Step title="拥有一个有默认钱包和账号的 Moove 账户">
    API 不会为一个无法收款的账户创建链接。
  </Step>

  <Step title="创建一个 API 密钥">
    在 [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys)，范围限定为 **Moove Receive Agent**。

    <Warning>
      密钥在创建时以明文显示一次。就在那时复制它——它无法再次显示。
    </Warning>

    [Moove API Keys →](/zh-hans/manage/moove-api-keys)
  </Step>

  <Step title="把密钥交给你的工具">
    作为环境变量。绝不要提交它，也绝不要把它粘贴进提示词。
  </Step>
</Steps>

## 代理是什么？

**代理** 是一个密钥上的权限单位。选一个，就是在决定这个密钥能做什么。

| 代理                      | 状态      | 它做什么             |
| ----------------------- | ------- | ---------------- |
| **Moove Receive Agent** | **已上线** | 创建一次性托管支付链接并读回它们 |
| Moove Send Agent        | 即将推出    | 向任意账号、地址或别名付款    |
| Moove Swap Agent        | 即将推出    | 处理好路由的兑换和跨链      |
| Moove Ramp Agent        | 即将推出    | 在本地货币与加密货币之间转移   |

<Warning>
  **只有 Moove Receive Agent 存在。** 另外三个只是宣布了，尚未建成——它们在选择器里显示为禁用并标注即将推出。今天的密钥只能持有 Moove Receive 的权限范围。
</Warning>

## Moove Receive Agent 能做什么？

两个权限范围，此外别无其他：

| 权限范围                  | 授予     |
| --------------------- | ------ |
| `payment_link:create` | 创建支付链接 |
| `payment_link:read`   | 列出支付链接 |

一个能发起收款请求却永远无法确认它是否结算的代理，完不成它存在的唯一那件事，所以 Moove Receive Agent 两个都有。

## 为什么泄露的密钥不会让你损失钱

<Note>
  密钥是 **你的一个缩小版**：它以你的账户身份行事，只能做你能做的事情中的一部分。

  没有任何接口能移动资金。支付链接总是结算到密钥所有者自己的默认钱包，而调用方无法指定目的地。泄露的密钥能创建付给 *你* 的收款请求——它无法把钱改道给别人。
</Note>

不再信任的密钥就吊销掉。吊销是永久且即时的。

## 不用代理也能做吗？

这个 API 就是一个普通的 HTTP API。它没有任何一处需要 AI 工具。

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99", "description": "INV-2026-0142", "maxUsage": 1 }'
```

[API 参考 →](/api-reference/introduction)

## 接下来读什么

<CardGroup cols={3}>
  <Card title="Moove API Keys" icon="key" href="/zh-hans/manage/moove-api-keys">
    创建、限定范围和吊销。
  </Card>

  <Card title="Moove Payment Links API" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    完整的接口。
  </Card>

  <Card title="Moove 收款" icon="hand-coins" href="/zh-hans/transact/moove-receive">
    同一个产品，不用写代码。
  </Card>
</CardGroup>

点击。集成。交易。你的资金。你的操作。