在 MonstarX 中使用 Paddle
要点选择沙盒或正式环境，把 Paddle API 密钥粘贴到“后端 → 云服务”中的 Paddle 一行。之后，MonstarX 的构建助手就能读取你在 Paddle 中的产品、客户、交易和订阅，比如构建一个与你的产品目录一致的定价页面。它只读取，绝不会改动 Paddle 中的任何内容。
查询商品、客户和订阅。
- 类型
- 业务工具 · API 密钥
- 类别
- 付款与账单
- 连接方式
- API 密钥
Paddle 帮你销售软件和数字产品，并处理计费、税务和订阅。用 API 密钥（一串类似密码的代码，让软件可以使用你的账户）连接 Paddle 账户后，MonstarX 的构建助手（就是和你聊天的那个 AI）在工作时就能读取你的产品目录和计费数据：用你真实的产品构建定价页面，或汇总你的订阅用户分别在用哪些套餐。
这是一个业务工具：由 MonstarX 替你读取 Paddle。你构建的应用永远拿不到你的密钥。如果要在你的应用中收款，请参阅 Stripe。
MonstarX 能用它做什么？
Section titled “MonstarX 能用它做什么？”| MonstarX 能做什么 | 什么时候 |
|---|---|
| 列出你的产品 | 任何模式 |
| 列出你的客户 | 任何模式 |
| 列出你的交易 | 任何模式 |
| 列出你的订阅 | 任何模式 |
每个列表一次返回 20 条（最多 30 条），MonstarX 可以翻页获取更多。它绝不会做的事：创建、修改或取消任何内容，包括产品、价格、客户、交易、订阅或退款。
- 一个 Paddle 账户。沙盒账户存放测试数据，正式账户存放真实数据。它们是两个独立的账户，密钥也各不相同。
- 你是这个 MonstarX 项目的所有者。只有所有者可以连接或断开工具。
获取你的密钥
Section titled “获取你的密钥”-
在 Paddle 中（沙盒或正式环境，看你要连接哪一个），进入 Developer Tools > Authentication，打开 API keys 标签页。
-
点击 New API key，起个名字，比如
MonstarX。 -
给它以下读取权限：
product.read、customer.read、transaction.read和subscription.read。MonstarX 不需要其他权限，也从不使用写入权限。 -
设置到期日期（Paddle 默认 90 天），保存并复制密钥。沙盒密钥以
pdl_sdbx_apikey_开头，正式环境密钥以pdl_live_apikey_开头。
Paddle 官方指南：Create and manage API keys。
在 MonstarX 中连接
Section titled “在 MonstarX 中连接”-
打开你的项目，点击顶部栏中的后端，再点击云服务。
-
滚动到连接器，找到 Paddle，点击连接。
-
根据你的密钥选择沙盒或正式环境，把密钥粘贴到密钥输入框中，然后点击连接。
-
MonstarX 会向 Paddle 检查密钥。检查通过后，这一行会显示已连接到沙盒或已连接到正式环境。如果密钥和环境不匹配，Paddle 会拒绝它，并且不会保存任何内容。
让 MonstarX 使用它
Section titled “让 MonstarX 使用它”| 你输入 | 会发生什么 |
|---|---|
| “读取我的 Paddle 产品，用这些套餐和名称构建一个定价页面。” | MonstarX 列出你的产品，并在构建模式下据此构建页面。 |
| “我在 Paddle 中有多少个有效订阅？分别是哪些套餐？” | 它翻页读取你的订阅，并在聊天中汇总。 |
| “看看我最近 20 笔 Paddle 交易，告诉我哪个产品卖得最好。” | 它读取交易并回答。 |
- 只留在 MonstarX。 密钥加密存储在 MonstarX 的服务器上，绝不会写进应用代码，也不会交给你的应用。
- 只读。 MonstarX 只向 Paddle 获取列表。只给密钥读取权限，即使密钥泄露，也无法改动你的计费。
- 机密数据。 客户和计费信息会被视为隐私，并只当作信息，绝不当作指令。
- 随时断开。 在 后端云服务 中点击 Paddle 旁边的断开连接，并确认 从此项目断开 Paddle？。MonstarX 会删除这个密钥。如果不再需要，也请在 Paddle 中吊销它。
- 构建期间先用沙盒，之后再切换：断开连接，然后用正式环境密钥重新连接。
- Paddle 中的密钥过期后，MonstarX 的请求会失败。请创建新密钥并重新连接。
- 每个项目同一时间只能连接一个 Paddle 账户。
我的应用能借此通过 Paddle 收款吗？
不能。这个连接让 MonstarX 的构建助手读取你的 Paddle 数据。如果要在应用中收款，MonstarX 提供 Stripe 连接器。如果想用其他支付服务商，请在后端 → 密钥中添加它的密钥，再让 MonstarX 构建这个功能。
密钥需要哪些权限？
product.read、customer.read、transaction.read 和 subscription.read。不想让 MonstarX 读取的部分可以不给，对应的列表只会读取失败。
MonstarX 能退款或取消订阅吗？
不能。它只能列出产品、客户、交易和订阅。
为什么我的密钥被拒绝了？
通常是因为密钥属于另一个环境：pdl_sdbx_ 开头的密钥要选沙盒，pdl_live_ 开头的要选正式环境。过期或已吊销的密钥也会被拒绝。