> ## 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**（一种由 PayPal 主动通知您网站的回调地址）：Lumi 会注册一个 webhook，当付款完成、被退款，或者订阅被激活、取消、暂停或续费失败时，您的网站都会收到通知。
* **价格页面和内容限制**：付费内容只会向已付款的客户显示。

您还可以随时向 Lumi 询问您的 PayPal 账户，例如“显示我最近的交易”“列出我的订阅计划”“给这个订单退款”或“取消这个订阅”。

> [!NOTE]
>
> PayPal 适用于 Web 项目。如果您没有指定支付服务商，Lumi 会使用 [Stripe](https://docs.lumi.new/zh-CN/features/stripe.md)。

## 连接您的 PayPal 凭证

**1. 在 PayPal 中创建 REST 应用**

在 PayPal 开发者控制台（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-CN/features/secrets.md)中。沙盒凭证只能用于沙盒环境，正式凭证只能用于正式环境。两者不匹配是 PayPal 拒绝凭证最常见的原因。

### 控制 Lumi 可以改动什么

在工具标签页的 **PayPal** 卡片上，每一个会改动您 PayPal 账户的操作都有一个审批设置：**总是允许**、**每次确认**或**禁止**。默认情况下，创建产品和计划是允许的，而**退款**和**取消订阅**每次都会请您批准。只读操作（例如列出交易）始终是允许的。

## 测试并上线

**1. 在沙盒中测试**

使用沙盒凭证时，不会有真实的资金流动。在 PayPal 付款页面上，用一个沙盒买家账户登录（PayPal 开发者控制台 → **Testing Tools** → **Sandbox Accounts** → 某个 Personal 账户的邮箱和密码）。付款之后，检查付款或订阅记录是否出现在[云端 → 数据](https://docs.lumi.new/zh-CN/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.