如何集成 BridgerPay

登录您的 BridgerPay 账户。

在主菜单中，前往 Checkouts。

点击 plus 图标以添加新的结账页面，然后填写以下字段：

• 在 Title 字段中，输入结账页面的标题。
• 在 Type 下拉列表中，选择 Payment link。

点击 Create。

在 B2CORE Back Office 中，前往 System > External connections。

点击页面右上角的 +Create。

在 Create connection 页面中，填写以下字段：

• 在 Name 字段中，输入连接名称。该名称必须唯一，且只能包含拉丁字母、数字、连字符和下划线（例如，Deposits_BridgerPay）。
• 在 Caption 字段中，输入将在 Back Office 中应用于该连接的标题。
• 在 Provider 下拉列表中，选择 PaymentSystemDeposit。

在出现的 Driver 下拉列表中，选择 BridgerPay。

在出现的 Credentials 部分中，配置 BridgerPay 专用设置：

• 在 API base URL 字段中，指定 https://api.bridgerpay.com。
• 在 API user name 和 API password 字段中，输入用于访问 BridgerPay API 的凭据。
• 在 API key 字段中，输入在您的 BridgerPay 账户中生成的 API 密钥。

点击 Save 以创建连接。

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

检查连接状态。

如果连接未激活（Enabled 列中显示 No），请点击 Edit 按钮以打开连接详情，并将 Enabled 下拉列表设置为 Yes。

点击 Save 以应用更改。

在 B2CORE Back Office 中，前往 System > Deposit system > Deposit methods。

点击页面右上角的 +Create。

在 Create a deposit method 页面中，填写以下字段：

• 在 Name 字段中，输入方法名称。该名称必须唯一，且只能包含拉丁字母、数字、连字符和下划线。
• 在 Caption 字段中，输入方法标题。此标题将分配给 Back Office 中的方法，并对 B2CORE UI 中的客户可见。
• 在 Provider 下拉列表中，选择 PaymentSystemDeposit。

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

• 在 Available account currencies 下拉列表中，选择一种或多种货币。通过 BridgerPay 入金将适用于以所选货币计价的账户。
• 在 Driver 下拉列表中，选择 BridgerPay。
• 在 Connection 下拉列表中，选择之前配置的 BridgerPay 连接。

在出现的 Configuration 部分中，完成以下设置：

• 在 Cashier key 字段中，指定 BridgerPay 提供的唯一标识符。

点击 Save 以创建入金方法。

BridgerPay 入金方法将显示在入金方法列表中。

点击 Edit 以进入方法详情，并完成以下字段：

• 在 Settings 选项卡上，使用 Group 下拉列表选择应包含该方法的一个或多个组。

• 在 Icon 字段中，指定 paymethod-bridgerpay，以便在 B2CORE UI 中显示 BridgerPay 入金方法的预定义图标。要使用自定义图标，请指定要显示的图像 URL。

• 检查方法状态。

  如果方法未激活（Enabled 字段中显示 No），请将 Enabled 下拉列表设置为 Yes 以激活该方法。

• 在 PS Currencies 选项卡上添加所需货币。要使该方法能够处理特定货币的入金，请确保已在此选项卡中添加该货币（有关选项卡说明，请参阅入金方法）。

• 如有需要，请在 Commissions 选项卡上配置该方法的佣金（有关详细信息，请参阅如何为入金和出金方法配置佣金）。

点击 Test configuration 以验证入金方法的连接设置。测试将根据方法表单中指定的设置以及所选外部连接中提供的数据执行。

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

成功验证配置后，点击 Save。

在 B2CORE Back Office 中，前往 System > Deposit system > Deposit methods。

找到已配置的 BridgerPay 入金方法，然后点击 Edit 以进入方法详情。

前往 Webhooks 选项卡。

复制 Notification URL 字段中显示的 URL。

登录您的 BridgerPay 账户。

在主菜单中，前往 Checkouts。

选择已添加的 PSP 并点击它以打开其详情。

在详情中，点击 Settings。

前往 URLs 选项卡。

将从 B2CORE Back Office 复制的 Webhook URL 粘贴到 Webhook Notification URL 字段中。

保存更改。

在您的 BridgerPay 账户中，前往主菜单中的 Checkouts。

选择已添加的 PSP 并点击它以打开其详情。

在详情中，点击 Settings。

前往 URLs 选项卡。

指定以下 URL：

• 在 Success Redirect URL 中，指定 https://{your-Front-Office-URL}/en/payment/success。
• 在 Failure Redirect URL 和 Cancel Redirect URL 字段中，指定 https://{your-Front-Office-URL}/en/payment/failed。

保存更改。

在您的 BridgerPay 账户中，前往主菜单中的 Checkouts。

选择已添加的 PSP 并点击它以打开其详情。

在详情中，点击 Settings。

在名为 PSP Specific Settings 的部分中，启用 Notify with original amount 选项。

保存更改。