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

> 追蹤你建立過的每一條付款連結，看看收到了什麼，並把你不想再讓它活著的那些停用。

看看你分享出去的每一條連結、它收到了什麼，並把你已經用完的關掉。

<Info>
  **僅限網頁。** 付款連結在 Moove 小工具中建立，在 [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link) 管理。Moove App 沒有付款連結頁面——它的 **接收** 頁面改為分享你的帳號和 QR 碼。
</Info>

## 有哪三種狀態？

| 狀態      | 意思               | 接受付款 |
| ------- | ---------------- | ---- |
| **啟用中** | 在線並已分享           | 是    |
| **已完成** | 已全額支付，或達到了使用次數上限 | 否    |
| **已失效** | 你把它停用了，或者它到期了    | 否    |

按狀態篩選清單，看看還有什麼在外面。

## 每條連結顯示什麼？

儀表板把你的連結列在一張表裡。它的欄是：

| 欄        | 顯示什麼                   |
| -------- | ---------------------- |
| **建立時間** | 你什麼時候做的                |
| **連結**   | 可分享的網址                 |
| **金額**   | 你要求的金額，以你的結算代幣計        |
| **狀態**   | 啟用中、已完成或已失效            |
| **到期日**  | 它什麼時候停止接受付款，或者 **永不**  |
| **已接收**  | 透過它實際支付了多少             |
| **描述**   | 付款方看到的內容               |
| **操作**   | **查看**、**分享** 和 **停用** |

## 我怎麼停用一條連結？

<Steps>
  <Step title="開啟管理 → 付款連結">
    在網頁儀表板上。
  </Step>

  <Step title="找到那條連結">
    清單很長的話就篩選 **啟用中**。
  </Step>

  <Step title="停用它">
    它的狀態會變成 **已失效**，並立即停止接受付款。
  </Step>
</Steps>

<Warning>
  停用是單向的。已失效的連結無法重新啟用——請另建一條。

  它也不會把已經發出去的網址收回來。拿著連結的人仍然拿著那個網址；只是它不再起作用了。如果連結放在公開頁面上，也請把那裡的撤下來。
</Warning>

## 讓連結自己關掉

在 Moove 小工具中建立的連結 **只接受一筆付款，且永不過期**。它一被全額支付就會完成，所以發票連結會自己收尾。

透過 [API](/api-reference/moove-receive/moove-payment-links) 建立的連結還可以設定兩項限制：

* **`maxUsage`**——連結在完成之前可以接受多少筆付款。
* **`expirationDate`**——它何時停止接受付款。過了到期時間的連結會變為 **已失效**。

<Tip>
  開發票的話，Moove 小工具的連結已經夠用：它只能被支付一次。如果你還需要一個截止日期，請透過 API 建立連結並設定 `expirationDate`。
</Tip>

## 與 Moove Transactions 對帳

透過連結完成的每一筆付款都與那條連結的 ID 關聯。網頁上的交易表格不顯示這個 ID，所以在那裡請按描述來對——或者透過 API 按連結 ID 來對。

[Moove Transactions →](/zh-hant/manage/moove-transactions)

## 用程式怎麼做？

API 會以同樣的狀態和同樣的欄位列出你的連結，包括從儀表板建立的、或由你帳戶上另一個金鑰建立的——所以它是用來對帳的那個接口。

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

<Note>
  API 可以建立和讀取連結。停用一條連結是儀表板上的操作。
</Note>

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

## 接下來讀什麼

<CardGroup cols={3}>
  <Card title="Moove 接收" icon="hand-coins" href="/zh-hant/transact/moove-receive">
    建立下一條。
  </Card>

  <Card title="Moove API Keys" icon="key" href="/zh-hant/manage/moove-api-keys">
    用程式建立連結。
  </Card>

  <Card title="Moove Transactions" icon="list" href="/zh-hant/manage/moove-transactions">
    看看支付了什麼。
  </Card>
</CardGroup>

每一條連結都有交代。你的資金。你的行動。