> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> 在您的網站中接受 PayPal 付款與訂閱。

您可以完全透過 Lumi 的聊天設定 PayPal 付款。請在需求中指明 PayPal，並描述您想販售的東西：

* 「讓大家用 PayPal 購買我的電子書，一次性 \$15。」
* 「新增一個透過 PayPal 收費、每月 \$9.99 的會員方案。」

有了您的 PayPal 應用程式憑證，Lumi 就能直接在您的 PayPal 商家帳戶中操作，並在網站中建立完整的付款流程：

* **一次性付款**：一個 PayPal 按鈕，會帶買家前往 PayPal 核准付款，然後將完成的付款記錄到您的資料庫中。
* **訂閱**：Lumi 會在您的 PayPal 帳戶中建立商品與訂閱方案（若已有名稱和價格相同的商品與方案，會直接沿用），加入訂閱按鈕，並持續更新每筆訂閱的狀態。
* **Webhook**：Lumi 會註冊一個 webhook，讓您的網站在付款完成、付款被退款，或訂閱被啟用、取消、暫停或續訂失敗時收到通知。
* **價格頁面與內容限制**：付費內容只會顯示給已付款的客戶。

您也可以隨時向 Lumi 詢問您的 PayPal 帳戶，例如「顯示我最近的交易」、「列出我的訂閱方案」、「將這筆訂單退款」或「取消這筆訂閱」。

> [!NOTE]
>
> PayPal 適用於網頁專案。如果您沒有指定付款服務，Lumi 會使用 [Stripe](https://docs.lumi.new/zh-TW/features/stripe.md)。

## 連接您的 PayPal 憑證

**1. 在 PayPal 中建立 REST 應用程式**

在 PayPal Developer Dashboard 中，前往 **Apps & Credentials**，建立或開啟一個 REST 應用程式。測試時使用 **Sandbox** 分頁，接受真實付款時使用 **Live** 分頁。複製該應用程式的 **Client ID** 和 **Secret key**。

**2. 在 Lumi 中輸入憑證**

您可以填寫 Lumi 在聊天中顯示的 PayPal 憑證卡片，或開啟工作區的 **工具** 分頁並點擊 **PayPal** 卡片。輸入 **PayPal client ID** 和 **PayPal client secret**，選擇 **Environment**（**沙盒（測試）** 或 **正式**），然後點擊 **儲存** 和 **驗證**。

> [!WARNING]
>
> 切勿將憑證貼到聊天訊息中。憑證會安全地儲存在專案的[密鑰](https://docs.lumi.new/zh-TW/features/secrets.md)中。沙盒憑證只能搭配沙盒環境使用，正式憑證也只能搭配正式環境使用。兩者不相符是 PayPal 拒絕憑證最常見的原因。

### 控制 Lumi 可以更改的內容

在工具分頁的 **PayPal** 卡片上，每個會更改您 PayPal 帳戶的動作都有審批設定：**總是允許**、**每次確認** 或 **禁止**。預設情況下，建立商品與方案是允許的，而 **退款** 和 **取消訂閱** 每次都會徵求您的核准。唯讀動作（例如列出交易）一律允許。

## 測試與上線

**1. 在沙盒中測試**

使用沙盒憑證時，不會有真實的金錢流動。在 PayPal 頁面上，使用沙盒買家帳戶登入（PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → 某個 Personal 帳戶的電子郵件和密碼）。付款後，確認付款或訂閱記錄出現在[雲端 → 資料](https://docs.lumi.new/zh-TW/features/databases.md)中，並且您的頁面顯示了此次購買。

**2. 切換到正式環境**

在 PayPal 中建立一個 Live 應用程式，然後在 **PayPal** 卡片上輸入它的 Client ID 和 Secret，並將 Environment 設為 **正式**。請 Lumi 切換到正式環境：沙盒中的商品和方案不會帶過來，因此 Lumi 會在您的正式帳戶中重新建立它們，並重新註冊 webhook。

**3. 最終測試與上線**

再用一個低價商品測試一次，然後發佈您的網站並分享出去。

如果任何步驟出了問題，請告訴 Lumi。它會檢查您的 PayPal 帳戶和函數的日誌，找出並修復問題。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.