支付与商店

适用于：一次性付款和订阅，使用由 Stripe 托管的结账页面。买家永远不会在你的应用里输入银行卡号。

连接方式：点击 Set up Stripe 按钮。你填写 Stripe 自己的表单，然后回来，过程中不会向你显示任何密钥。请先发布应用，因为 Stripe 会查看线上的网站，并拒绝仍在制作中的网站。它会要求提供一份身份证件和一个银行账户。你也可以改用密钥：来自你的 Stripe API 密钥的可公开密钥（以 pk_ 开头）和私密密钥（以 sk_ 开头），以及一个 webhook 签名密钥（以 whsec_ 开头）。

仅限手动粘贴密钥时：Stripe 卡片会显示要在 Stripe 中添加的 webhook 地址，旁边有复制按钮。请为事件 checkout.session.completed 和 checkout.session.async_payment_succeeded 添加它。使用按钮连接时，不需要设置 webhook。

你可以这样要求：

• “为这门课程添加一个 Buy now 按钮”
• “添加一个月度套餐和一个 Manage billing 按钮”
• “添加一个 My orders 页面”

会发生什么：Stripe 确认一笔付款已经完成时，订单就会被写入，并显示在 Manage，然后 Payments 下。请看网上商店。

限制：应用可以发起一次结账、读回结账结果，并读取你的价格表。退款、客户和付款到账，应用无法触及。请在 Manage，然后 Payments 中退款，或者在 Stripe 中退款。Manage billing 只对在该应用里买过东西且已登录的人有效。

适用于：由 Paddle 作为卖方来销售的支付和订阅，所以增值税和销售税由它替你处理。跨境销售时很值得用。

连接方式：密钥，来自 Paddle 的身份验证页面。

• Client-side Token（以 live_ 开头，沙盒环境则以 test_ 开头）。按设计就是公开的，所以它会内置在发布的应用中。
• API Key（以 pdl_live_apikey_ 或 pdl_test_apikey_ 开头）。保留在 Setherion 的服务器上。
• Webhook Secret（以 pdl_ntfset_ 开头）。可选。

你可以这样要求：

• “添加一个 Pro 套餐，带一个会打开 Paddle 结账的 Subscribe 按钮”
• “在结账打开之前，显示价格和包含的内容”

工作方式：结账在访客浏览器里 Paddle 自己的浮层中打开。你在 Paddle 仪表盘中创建价格，应用通过它们的 pri_ ID 来使用。页面从不发送金额，因为任何打开页面的人都可以修改它。

限制：发布的应用没有服务器，所以不会用到 API 密钥。以 test_ 开头的令牌只能用于 Paddle 的沙盒。Test connection 会从你的 Paddle 账户读取一个商品。

适用于：以固定价格购买单件商品的 Buy 按钮。价格、税费和运费都在 PayPal 里，所以打开页面的任何人都无法改变自己要付的金额。买家在 PayPal 自己的窗口中付款，用 PayPal 账户或银行卡都可以。

连接方式：两个值。

• Client ID：在 PayPal 中，打开 Pay links and buttons，然后打开一个按钮，再打开它的代码。它是 client-id= 后面的值。按设计就是公开的。
• Currency：三个字母，比如 GBP 或 EUR，与你在 PayPal 中的按钮上所用的一致。

请先制作好你的按钮，在 PayPal 的按钮页面。

你可以这样要求：

• “为这三幅版画各添加一个 PayPal Buy 按钮”
• “把 PayPal 按钮放在商品页面的价格下面”

限制：每个按钮以在 PayPal 中设定的价格购买一件商品。没有购物车。有人付款时，你的应用不会得到通知：PayPal 会给你和买家发邮件，这笔销售不会记录在应用里。如果需要购物车、保存在你应用里的订单或订阅，请改为连接 Stripe 或 Paddle。该连接器的页面上也是这样说的。

适用于：订阅计费。Subscribe 按钮会打开 Chargebee 托管的结账页面，Manage billing 按钮会打开客户门户，你的团队可以查看客户、订阅和发票。

连接方式：密钥。

• Site name：你仪表盘地址中 .chargebee.com 前面的那部分，小写。
• API key：在 Chargebee 中，依次打开 Settings、Configure Chargebee、API Keys，然后点击 Add API Key。选择 Write Key（可创建、读取和更新，永远不能删除）。应用只需要这些。

你可以这样要求：

• “根据我的 Chargebee 套餐添加一个价格页面，每个套餐上都有一个 Subscribe 按钮”
• “为已登录的客户添加一个 Manage billing 按钮”
• “做一个团队页面，显示我的订阅和未付发票”

谁能做什么：访客可以发起结账、打开计费门户，以及为价格页面读取在售的套餐和价格。客户、订阅和发票，以及修改套餐和价格，只对你的团队开放。请在 Manage，然后 Cloud，然后 Users 中标记哪些账户是你的团队。

限制：它使用 Chargebee Product Catalog 2.0，所以套餐就是商品价格。金额以便士或美分为单位。无法从应用中删除。在 Permissions 中，你可以分别关闭结账、门户，以及客户、订阅、发票、套餐和价格各自的读取和修改。

适用于：基于 Shopify 商店的一个新店面。商品、价格和库存都留在 Shopify 里，买家在 Shopify 自己的结账页面付款。

连接方式：两个值。

• Store domain：以 .myshopify.com 结尾的地址，即使你的店铺向客户显示的是自定义域名也一样。
• Storefront API token (public)：在 Shopify 管理后台，依次打开 Sales channels、Headless，然后点击 Create storefront。复制它的公开访问令牌。

永远不要使用 Admin API 令牌（它以 shpat_ 开头）：卡片会拒绝它，因为这个令牌会内置在发布的应用中，任何人都能读到。

你可以这样要求：

• “为我的 Shopify 商店做一个新店面，首页上显示各个系列”
• “添加一个购物车，把买家送到 Shopify 结账页面”
• “对我的 Shopify 商品添加搜索和筛选”

权限：Shopify 不同。你的应用直接在页面里用公开令牌调用它，所以 Setherion 里没有开关。请在 Shopify 中设置限制：Sales channels、Headless、你的店面，然后点击 Storefront API 旁边的 Manage，再打开 Permissions。这些限制适用于 Headless 渠道中的每一个店面。

限制：库存、订单和支付都留在 Shopify 里。如果某件商品缺货，应用会在把买家送过去之前说明发生了什么变化。

适用于：展示你真实 WooCommerce 商品的店面，并把买家送到你自己的结账页面。

连接方式：密钥。

• Shop address：你的店铺所运行的地址，也就是后面跟着 /wp-admin 的那个。
• Consumer key（以 ck_ 开头）和 Consumer secret（以 cs_ 开头）：在 WooCommerce 中，依次打开 Settings、Advanced、REST API，然后点击 Add key，并把 Permissions 设为 Read。

两个密钥都保留在 Setherion 的服务器上。

你可以这样要求：

• “用网格展示我的 WooCommerce 商品，每个商品上都有一个 Buy 按钮”
• “为每个商品添加一个页面，显示它的照片和价格”

限制：应用只能读取商品。订单和客户会被拒绝，所以这里没有订单历史，也没有客户账户。购买发生在你的店铺里：按钮会把买家送到你的结账页面，并已加入该商品。价格以店铺自己的币种显示，与店铺给出的一致。Test connection 会读取一个商品。

适用于：展示你真实 PrestaShop 商品的店面，并把买家送到你店铺中每个商品自己的页面。

连接方式：密钥。

• Shop address：你的店铺所运行的地址，也就是后面跟着 /admin 的那个。
• Webservice key：32 个字母和数字。在 PrestaShop 中，依次打开 Advanced Parameters、Web service，然后点击 Add new webservice key，并在 products 上勾选 View (GET)。

这个密钥保留在 Setherion 的服务器上。

你可以这样要求：

• “显示我的 PrestaShop 商品及其照片和价格”
• “把每个商品链接到它在我店铺里的页面”

限制：应用只能读取商品。订单和客户会被拒绝，库存数量也无法获得，所以应用不会显示“有货”标记。PrestaShop 的价格不含税，应用也会这样标注。买家会被送到你店铺里的商品页面，而不是直接送到购物篮。