如何集成 Stripe

了解如何通过 PSS 将 Stripe 与 B2CORE 集成，使客户能够通过 Stripe 托管的结账页面使用受支持的货币入金，包括设置连接、添加入金方式和配置 Webhook

Stripe 可通过 PSS 连接到 B2CORE，支持以 EUR、GBP 和 USD 处理入金。客户会被重定向至 Stripe 托管的结账页面以完成支付。

请按照以下说明配置 Stripe 连接、在 B2CORE Back Office 中设置入金方式，并在 Stripe 中注册 Webhook。这些说明遵循为 PSS 支持的支付系统添加方式的常规流程，同时包含 Stripe 特有的详细信息。

继续操作之前，您必须已注册 Stripe 并拥有有效账户。如有疑问，您可以查阅官方 Stripe 文档，或联系其支持团队。

配置 Stripe 连接

要配置用于入金的 Stripe 连接：

在 B2CORE Back Office 中，导航至系统 > 外部连接。

点击页面右上角的 +创建。

在创建连接页面，填写以下字段：

在名称字段中，输入连接名称。名称必须唯一，且只能包含拉丁字母、数字、连字符和下划线（例如 Deposits_Stripe）。
在显示名称字段中，输入该连接在 Back Office 中显示的名称。
在提供商下拉列表中，选择 PaymentSystemDeposit。

在出现的驱动程序下拉列表中，选择 Stripe。

在出现的凭据部分，配置 Stripe 专用设置：

在 API 基础 URL 字段中，保留默认值 https://api.stripe.com。正式环境和测试环境使用相同的 URL。
在密钥字段中，输入在您的 Stripe 账户中生成的秘密 API 密钥或受限 API 密钥。环境由密钥决定：正式环境使用正式密钥，测试环境使用测试密钥。

要获取密钥，请登录 Stripe 仪表板，然后导航至开发者 > API 密钥（详情请参阅 API 密钥）。

如果您使用受限密钥，请确保该密钥拥有余额的读取权限和结账会话的写入权限。配置测试仅验证余额权限。

点击保存以创建连接。

Stripe 连接将显示在外部连接列表中。

检查连接状态。

如果连接未启用（已启用列中显示 No），请点击编辑按钮打开连接详情，并将已启用下拉列表设置为 Yes。

点击保存以应用更改。

添加 Stripe 入金方式

要添加并设置通过 Stripe 入金的方式：

在 B2CORE Back Office 中，导航至系统 > 入金系统 > 入金方式。

点击页面右上角的 +创建。

在创建入金方式页面，填写以下字段：

在名称字段中，输入入金方式的名称。名称必须唯一，且只能包含拉丁字母、数字、连字符和下划线。
在显示名称字段中，输入入金方式的显示名称。该名称将用于 Back Office 中的入金方式，并显示在 B2CORE UI 中供客户查看。
在提供商下拉列表中，选择 PaymentSystemDeposit。

选择 PaymentSystemDeposit 后，会出现以下字段：

在可用账户货币下拉列表中，选择一种或多种货币。以所选货币计价的账户将可以通过 Stripe 入金。
在驱动程序下拉列表中，选择 Stripe。
在连接下拉列表中，选择之前配置的 Stripe 连接。

点击保存以创建入金方式。

Stripe 入金方式将显示在入金方式列表中。

点击编辑进入入金方式详情，并完成以下字段：

在设置选项卡上，使用组下拉列表选择应包含此入金方式的一个或多个组。
在图标字段中，指定 paymethod-stripe，以便在 B2CORE UI 中显示 Stripe 入金方式的预定义图标。要使用自定义图标，请指定要显示的图片 URL。
检查入金方式的状态。

如果该方式未启用（已启用字段中显示 No），请将已启用下拉列表设置为 Yes 以启用它。
在 PS 货币选项卡上，添加所需货币，例如 EUR、GBP 和 USD。通过 Stripe 进行的入金将以此选项卡中添加的货币处理（有关该选项卡的说明，请参阅入金方式）。
如有需要，在佣金选项卡上为该方式配置佣金（详情请参阅如何为入金和出金方式配置佣金）。

点击测试配置以验证入金方式的连接设置。测试基于入金方式表单中指定的设置以及所选外部连接提供的数据进行。

测试结果将显示在页面上。

成功验证配置后，点击保存。

Stripe 入金方式现已在 B2CORE Back Office 中配置完成。

限制

Stripe 入金方式没有内置的最低和最高金额检查。请在 B2CORE 中为该方式配置金额限额，以符合 Stripe 的要求。

在 Stripe 中设置 Webhook

要在 B2CORE 中接收已发起入金的状态更新，您需要在 Stripe 仪表板中创建一个带有 Webhook 端点的事件目标。

从 B2CORE Back Office 复制 Webhook URL

在 B2CORE Back Office 中，导航至系统 > 入金系统 > 入金方式。

找到已配置的 Stripe 入金方式，点击编辑进入方式详情。

转到 Webhook 选项卡。

复制通知 URL 字段中显示的 URL。

在 Stripe 中创建事件目标

在选择事件步骤中，配置以下设置：

在事件目标范围下，选择您的账户。
在载荷样式下，选择 Snapshot。B2CORE 会从事件载荷中读取结账会话 ID，而精简载荷不包含该 ID。
在事件下，选择以下事件（它们列在结账组中）：
- checkout.session.completed
- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
- checkout.session.expired

在选择目标类型步骤中，选择 Webhook 端点。

在配置您的目标步骤中，填写以下字段：

在目标名称字段中，输入目标名称或保留生成的名称。
在端点 URL 字段中，粘贴从 B2CORE Back Office 复制的 Webhook URL。
如有需要，添加目标的描述。

点击创建目标。

有关事件目标的详情，请参阅 Stripe 文档。