> ## 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 Agentic Payments

> Dựng một quầy thanh toán tiền mã hóa chỉ với một prompt — tải skill Moove Agent vào công cụ lập trình AI của bạn và để nó tích hợp payment-link API đang chạy thật.

Nhận thanh toán tiền mã hóa trên website của chính bạn — bằng cách dán một prompt vào công cụ lập trình AI của bạn.

<Info>
  **Web.** Trang giới thiệu, bảng điều khiển và các bản tải về đều nằm trên web. Không có bản tương đương trên di động.
</Info>

## Moove Agentic Payments là gì?

Moove Agentic Payments là một **tệp skill** — một tệp hướng dẫn mà công cụ lập trình AI của bạn đọc — dạy cho công cụ đó cách tích hợp payment-link API đang chạy thật của moove.xyz.

Bạn tải nó về, thả vào công cụ của mình, và mô tả điều bạn muốn. Công cụ viết phần tích hợp với API thật.

<Note>
  Skill không bao giờ chuyển tiền. Nó đọc tài liệu và viết mã. Mọi khoản thanh toán vẫn quyết toán on-chain vào chiếc ví thuộc tài khoản của khóa API, và bản thân khóa đó không thể chuyển hướng tiền đi đâu khác.
</Note>

## Tôi tích hợp trong ba bước thế nào?

<Steps>
  <Step title="Tải skill hoặc một plugin">
    Một tệp `skill.md` chạy được ở mọi nơi. Các plugin đóng gói lại chính tệp đó vào đúng vị trí mà công cụ cụ thể của bạn tìm tới.
  </Step>

  <Step title="Chèn một prompt">
    Dùng prompt có sẵn tại [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments), hoặc tự viết prompt của bạn.
  </Step>

  <Step title="Dựng và triển khai">
    Công cụ của bạn dựng quầy thanh toán. Quản lý các khóa, liên kết và giao dịch nó tạo ra trong [Moove Manage](/vi-vn/manage/overview).
  </Step>
</Steps>

## Năm plugin là gì?

Moove Agent Skills tuân theo một chuẩn mở, nên cùng một tệp chạy được trên hơn 40 mô hình AI. Các plugin là tiện lợi, không phải bắt buộc.

| Công cụ            | Plugin cài gì                         |
| ------------------ | ------------------------------------- |
| **Claude Code**    | Một manifest plugin cộng với skill    |
| **Codex**          | `AGENTS.md`                           |
| **Gemini CLI**     | `GEMINI.md`                           |
| **Cursor**         | Một tệp quy tắc dưới `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md`     |

Tải bất kỳ cái nào trong số đó từ [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments).

<Tip>
  Không dùng một trong năm công cụ đó? Hãy tải tệp `skill.md` thuần và đặt nó vào bất cứ đâu công cụ của bạn đọc hướng dẫn. Vẫn là cùng một tệp.
</Tip>

## Trước khi bạn bắt đầu

<Steps>
  <Step title="Có một tài khoản Moove với ví mặc định và một handle">
    API từ chối tạo liên kết cho một tài khoản không thể nhận thanh toán.
  </Step>

  <Step title="Tạo một khóa API">
    Tại [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), giới hạn phạm vi cho **Moove Receive Agent**.

    <Warning>
      Khóa được hiển thị một lần, ở dạng văn bản thuần, lúc tạo. Hãy sao chép ngay lúc đó — nó không thể hiện lại lần nữa.
    </Warning>

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

  <Step title="Đưa khóa cho công cụ của bạn">
    Dưới dạng một biến môi trường. Đừng bao giờ commit nó, và đừng bao giờ dán nó vào một prompt.
  </Step>
</Steps>

## Các agent là gì?

Một **agent** là đơn vị quyền trên một khóa. Chọn một agent chính là cách bạn quyết định một khóa làm được gì.

| Agent                   | Trạng thái         | Nó làm gì                                                              |
| ----------------------- | ------------------ | ---------------------------------------------------------------------- |
| **Moove Receive Agent** | **Đang hoạt động** | Tạo các liên kết thanh toán dùng một lần được lưu trữ và đọc lại chúng |
| Moove Send Agent        | Sắp ra mắt         | Chi trả tới bất kỳ handle, địa chỉ hay bí danh nào                     |
| Moove Swap Agent        | Sắp ra mắt         | Hoán đổi và bắc cầu với phần định tuyến được lo sẵn                    |
| Moove Ramp Agent        | Sắp ra mắt         | Chuyển đổi giữa tiền tệ địa phương và tiền mã hóa                      |

<Warning>
  **Chỉ có Moove Receive Agent là tồn tại.** Ba agent còn lại mới được công bố chứ chưa được xây dựng — chúng hiện ra trong bộ chọn ở trạng thái vô hiệu và gắn nhãn sắp ra mắt. Hôm nay một khóa chỉ có thể mang các phạm vi của Moove Receive.
</Warning>

## Moove Receive Agent làm được gì?

Hai phạm vi, và không gì khác:

| Phạm vi               | Cấp quyền                   |
| --------------------- | --------------------------- |
| `payment_link:create` | Tạo liên kết thanh toán     |
| `payment_link:read`   | Liệt kê liên kết thanh toán |

Một agent có thể yêu cầu một khoản thanh toán nhưng không bao giờ xác nhận được là nó đã hoàn tất thì không thể làm trọn công việc duy nhất mà nó tồn tại vì nó, nên Moove Receive Agent được cấp cả hai.

## Vì sao một khóa bị lộ không thể khiến bạn mất tiền

<Note>
  Một khóa là một **bản thu hẹp phạm vi của chính bạn**: nó hành động với tư cách tài khoản của bạn và chỉ làm được một tập con những gì bạn làm được.

  Không có endpoint nào chuyển tiền. Liên kết thanh toán luôn quyết toán vào ví mặc định của chính chủ khóa, và bên gọi không thể chỉ định một đích đến. Một khóa bị lộ có thể tạo ra các yêu cầu thanh toán trả tiền cho *bạn* — nó không thể chuyển hướng tiền tới bất kỳ ai khác.
</Note>

Hãy thu hồi một khóa bạn không còn tin tưởng. Việc thu hồi là vĩnh viễn và tức thì.

## Tôi làm được mà không cần agent không?

API là một HTTP API thuần. Không có gì trong đó đòi hỏi một công cụ 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 }'
```

[Tham chiếu API →](/api-reference/introduction)

## Nên đọc gì tiếp theo

<CardGroup cols={3}>
  <Card title="Moove API Keys" icon="key" href="/vi-vn/manage/moove-api-keys">
    Tạo, giới hạn phạm vi và thu hồi.
  </Card>

  <Card title="Moove Payment Links API" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    Toàn bộ các endpoint.
  </Card>

  <Card title="Moove Nhận" icon="hand-coins" href="/vi-vn/transact/moove-receive">
    Cùng sản phẩm đó, không cần mã.
  </Card>
</CardGroup>

Nhấn. Tích hợp. Giao dịch. Tiền của bạn. Nước đi của bạn.