> ## 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-hant/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-hant/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-hant/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-hant/transact/moove-receive">
    同一個產品，不用寫程式。
  </Card>
</CardGroup>

點擊。整合。交易。你的資金。你的行動。