> ## 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 Payment Links

> Theo dõi mọi liên kết thanh toán bạn đã tạo, xem cái nào đã được trả, và hủy kích hoạt những cái bạn không còn muốn để hoạt động.

Xem mọi liên kết bạn đã chia sẻ, nó đã nhận được gì, và đóng lại những cái bạn đã xong việc.

<Info>
  **Chỉ trên web.** Liên kết thanh toán được tạo trong Moove Widget và quản lý tại [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link). Moove App không có màn hình liên kết thanh toán — màn hình **Nhận** của nó chia sẻ handle và mã QR của bạn thay vào đó.
</Info>

## Ba trạng thái là gì?

| Trạng thái          | Ý nghĩa                                           | Nhận thanh toán |
| ------------------- | ------------------------------------------------- | --------------- |
| **Đang hoạt động**  | Đang chạy và đã chia sẻ                           | Có              |
| **Đã hoàn tất**     | Đã được trả đủ, hoặc đã chạm giới hạn số lần dùng | Không           |
| **Không hoạt động** | Bạn đã hủy kích hoạt nó, hoặc nó đã hết hạn       | Không           |

Lọc danh sách theo trạng thái để xem cái nào vẫn còn ngoài kia.

## Mỗi liên kết hiển thị gì?

Bảng điều khiển liệt kê các liên kết của bạn trong một bảng. Đây là các cột của nó:

| Cột              | Nó hiển thị gì                                               |
| ---------------- | ------------------------------------------------------------ |
| **Ngày tạo**     | Khi bạn tạo ra nó                                            |
| **Liên kết**     | URL chia sẻ được                                             |
| **Số tiền**      | Số tiền bạn đang yêu cầu, tính theo token quyết toán của bạn |
| **Trạng thái**   | Đang hoạt động, Đã hoàn tất hoặc Không hoạt động             |
| **Ngày hết hạn** | Khi nào nó ngừng nhận thanh toán, hoặc **Không bao giờ**     |
| **Đã nhận**      | Số tiền thực sự đã được trả vào nó                           |
| **Mô tả**        | Thứ người trả nhìn thấy                                      |
| **Hành động**    | **Xem**, **Chia sẻ** và **Hủy kích hoạt**                    |

## Tôi hủy kích hoạt một liên kết thế nào?

<Steps>
  <Step title="Mở Quản lý → Liên kết thanh toán">
    Trên bảng điều khiển web.
  </Step>

  <Step title="Tìm liên kết">
    Lọc tới **Đang hoạt động** nếu danh sách dài.
  </Step>

  <Step title="Hủy kích hoạt nó">
    Trạng thái của nó chuyển thành **không hoạt động** và nó ngừng nhận thanh toán ngay lập tức.
  </Step>
</Steps>

<Warning>
  Hủy kích hoạt là một chiều. Một liên kết không hoạt động không thể kích hoạt lại — hãy tạo một liên kết mới thay vào đó.

  Nó cũng không thu hồi lại URL đã gửi đi. Ai đang giữ liên kết thì vẫn giữ URL; nó chỉ đơn giản là thôi hoạt động. Nếu liên kết nằm trên một trang công khai, hãy gỡ nó ở đó nữa.
</Warning>

## Để một liên kết tự đóng lại

Một liên kết tạo trong Moove Widget nhận **một khoản thanh toán và không bao giờ hết hạn**. Nó hoàn tất ngay khi được trả đủ, nên một liên kết hóa đơn tự dọn dẹp.

Các liên kết tạo qua [API](/api-reference/moove-receive/moove-payment-links) còn có thể đặt hai giới hạn:

* **`maxUsage`** — liên kết nhận bao nhiêu khoản thanh toán trước khi hoàn tất.
* **`expirationDate`** — khi nào nó ngừng nhận thanh toán. Một liên kết đã quá hạn chuyển sang **Không hoạt động**.

<Tip>
  Với hóa đơn, một liên kết Moove Widget đã làm được việc đó: nó chỉ trả được một lần. Nếu bạn cần cả hạn chót, hãy tạo liên kết qua API với `expirationDate`.
</Tip>

## Đối soát với Moove Transactions

Mọi khoản thanh toán qua một liên kết đều gắn với id của liên kết đó. Id này không hiển thị trong bảng Giao dịch trên web, nên hãy đối soát ở đó theo mô tả — hoặc theo id liên kết qua API.

[Moove Transactions →](/vi-vn/manage/moove-transactions)

## Tôi làm việc đó bằng mã thế nào?

API liệt kê các liên kết của bạn với cùng những trạng thái và cùng những trường đó, bao gồm cả các liên kết tạo từ bảng điều khiển hoặc bởi một khóa khác trong tài khoản của bạn — nên đó là endpoint để đối soát.

```bash theme={null}
curl -sS "https://api.moove.xyz/v1/payment-link?status=active" \
  -H "X-API-Key: $MOOVE_API_KEY"
```

<Note>
  API có thể tạo và đọc liên kết. Hủy kích hoạt một liên kết là một thao tác trên bảng điều khiển.
</Note>

[Moove Payment Links API →](/api-reference/moove-receive/moove-payment-links)

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

<CardGroup cols={3}>
  <Card title="Moove Nhận" icon="hand-coins" href="/vi-vn/transact/moove-receive">
    Tạo liên kết tiếp theo.
  </Card>

  <Card title="Moove API Keys" icon="key" href="/vi-vn/manage/moove-api-keys">
    Tạo liên kết bằng mã.
  </Card>

  <Card title="Moove Transactions" icon="list" href="/vi-vn/manage/moove-transactions">
    Xem cái gì đã được trả.
  </Card>
</CardGroup>

Mọi liên kết đều được ghi nhận. Tiền của bạn. Nước đi của bạn.