<!-- Source: https://docs.infraio.xyz/zh-TW/payment-links/overview -->
<!-- Last updated: 2026-10-04 -->

# 付款連結 — 總覽

**付款連結**是一個可分享的 URL，會把買家導向一個你已經設定好的
託管結帳頁。不需要 SDK，也不需要伺服器整合 — 在儀表板中發行、
分享出去，資金在鏈上確認時就會觸發同一個 `payment.settled`
webhook。

從底層來看，付款連結**就是**一個 [CheckoutSession](https://docs.infraio.xyz/zh-TW/concepts/sessions) —
「付款連結」只是儀表板端對「非由買家驅動的 SDK 流程所建立的
session」的稱呼。webhook 契約相同、鏈上結算方式相同、費用也
相同。

常見用途：

- 不用寫程式，就能對一次性客戶開立請款單
- 你沒有客製購物車的銷售頁面
- B2B 後續請款:把連結貼進 email 即可
- 「請我喝杯咖啡」風格的固定金額打賞頁面

## 建立一個付款連結

請在儀表板中建立付款連結：

1. 登入[商家儀表板](https://app.infraio.xyz)
2. **Payments → Payment Links → + New link**
3. 選擇下列兩條路徑之一：
   - **New order** — 輸入商品項目、幣別、客戶資訊，以及選填的
     metadata。儀表板會在同一次呼叫中同時建立 Order 與付款
     連結。
   - **Existing order** — 選一個 `PENDING` 的訂單（例如買家放棄
     了前一個連結）。系統會重新發行一個新連結，並掛在同一筆
     訂單上，讓訂單歷史保持完整。
   - 在 **New order** 中可切換到 **僅金額**，無需列出商品即可收取固定金額。
4. 儲存 → 儀表板會顯示 `https://checkout.infraio.xyz/cst_…`
   URL，附上複製按鈕與可下載的 QR code。測試模式的連結會使用
   `checkout-dev.infraio.xyz`，讓環境直接編碼在主機名稱中。

> **Note:**
>
> 目前每個付款連結都是單次使用：買家一旦付款，session 就會變成
> `COMPLETED`。若 session 在付款前就過期（預設 TTL 為 30
> 分鐘），請到訂單詳情頁點擊**重新建立連結**，針對同一筆訂單
> 發行新的連結。

## 買家會看到什麼

1. 買家會抵達 `checkout.infraio.xyz/<session_key>` — 與 SDK
   發行的 session 完全相同的託管結帳頁 UI。
2. 買家會經歷[結帳 — 總覽](https://docs.infraio.xyz/zh-TW/checkout/overview)中所描述的
   標準流程：選資產 → 送出資金 → 等待確認。
3. `payment.settled` 會觸發你的 webhook，帶著訂單、intent、
   收據、鏈上交易雜湊與確認數 — 與任何其他已結算付款的酬載
   完全相同。schema 請見 [Webhooks](https://docs.infraio.xyz/zh-TW/webhooks/overview)。

## 儀表板能提供什麼

付款連結目前在儀表板上提供：

- **列表檢視** — 你發行過的每一個連結，採游標分頁，顯示狀態、
  金額、所屬訂單編號、客戶、到期時間，並可一鍵開啟買家看到的
  URL。
- **篩選器** — 狀態（`ACTIVE` / `COMPLETED` / `EXPIRED` /
  `CANCELED`）、日期區間，以及跨訂單編號、客戶姓名、email 或
  外部參考的全文檢索。
- **CSV 匯出** — 一鍵匯出，會套用目前的篩選條件。
- **KPI 摘要條** — 依目前環境（`live` 或 `test`）統計各狀態的數量，
  與表格所顯示的一致。
- **詳情頁** — 訂單摘要、session 歷史（這筆訂單的每一次嘗試）、
  帶區塊瀏覽器連結的鏈上歷史，以及針對付款前過期的 session 提供
  的**重新建立連結**操作。

## 目前的限制

- **沒有程式化 API** — 連結必須在儀表板中建立。你可以透過
  `POST /b2b/v1/checkout-sessions/quick` 建立等效的單次使用
  session（見 [API 參考](https://docs.infraio.xyz/zh-TW/api-reference)），但可分享的連結
  只能在儀表板建立。
- **沒有逐買家的身分驗證** — 任何拿到這個 URL 的人都可以付款。
  每個連結都是單次使用，可降低這方面的風險。
- **品牌設定是全域的** — 連結會使用你在**設定 → Branding**
  中設定的商家層級 Logo、品牌色與邊框圓角。不提供逐連結的品牌覆寫。

## 另請參閱

- [概念 → 工作階段](https://docs.infraio.xyz/zh-TW/concepts/sessions) — 買家付款期間，
  session 與 intent 層發生了什麼事。
- [結帳 — 總覽](https://docs.infraio.xyz/zh-TW/checkout/overview) — 買家實際看到的畫面。
- [Webhooks → 總覽](https://docs.infraio.xyz/zh-TW/webhooks/overview) — 你的伺服器要回應
  的 `payment.settled` 事件。