如何集成 Proxpay

了解如何通过 PSS 将 Proxpay 与 B2CORE 集成，包括配置连接以及添加支持币种的入金和出金方式

Proxpay 可通过 PSS 连接到 B2CORE。它支持通过二维码入金以及向银行账户出金，并以 THB 进行处理。

请按照以下说明配置 Proxpay 连接，并在 B2CORE Back Office 中设置入金和出金方式。这些说明与通过 PSS 支持的支付系统添加方式的常规流程一致，但包含 Proxpay 特有的详细信息。

在继续执行说明之前，您必须已注册 Proxpay 并拥有有效账户。

配置与 Proxpay 的连接

如果您计划将 Proxpay 同时用于入金和出金，则必须配置两个独立连接：一个用于入金，另一个用于出金。

要配置与 Proxpay 的连接：

在 B2CORE Back Office 中，转到 System > External connections。

点击页面右上角的 +Create。

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

在 Name 字段中，输入连接名称。该名称必须唯一，且只能包含拉丁字母、数字、连字符和下划线（例如，Deposits_Proxpay 或 Withdrawals_Proxpay）。
在 Caption 字段中，输入将在 Back Office 中应用于该连接的标题。
在 Provider 下拉列表中，选择：
- PaymentSystemDeposit — 添加将用于入金方式的连接。
- PaymentSystemWithdrawal — 添加将用于出金方式的连接。

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

在出现的 Credentials 部分中，配置 Proxpay 专属设置。

用于入金：

在 API base URL 字段中，指定：
- https://api.proxpay.co — 用于生产环境
- https://stg-api.proxpay.co — 用于沙盒测试环境
在 API key 字段中，输入由 Proxpay 提供的、用于验证请求的 API 密钥。
在 Username 和 Password 字段中，指定与您的 Merchant ID 关联的凭据。
在 API start base URL 字段中，指定 https://payment.thehabito.com。此 URL 仅适用于生产环境，测试环境中不可用。
在 Start token 字段中，输入用于通过 Proxpay 发起 API 会话的令牌。
在 Merchant ID 字段中，指定由 Proxpay 分配给您的 Merchant ID。
在 Proxpay merchant ID 字段中，指定用于二维码入金的唯一商户标识符。

用于出金：

在 API base URL 字段中，指定：
- https://api.proxpay.co — 用于生产环境
- https://stg-api.proxpay.co — 用于沙盒测试环境
在 API key 字段中，输入由 Proxpay 提供的、用于验证请求的 API 密钥。
在 Username 和 Password 字段中，指定与您的 Merchant ID 关联的凭据。
在 Merchant ID 字段中，指定由 Proxpay 分配给您的 Merchant ID。

您需要向 Proxpay 支持团队申请配置连接所需的全部凭据。

点击 Save 创建连接。

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

检查连接状态。

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

点击 Save 应用更改。

如果您需要支持通过 Proxpay 进行入金和出金，请按照相同说明为另一项操作创建新连接。

通过 Proxpay 添加入金方式

要添加并设置通过 Proxpay 进行入金的方式：

在 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 下拉列表中，选择一种或多种币种。通过 Proxpay 的入金将适用于以所选币种计价的账户。必须为这些币种配置 THB 的转换汇率。
在 Driver 下拉列表中，选择 Proxpay。
在 Connection 下拉列表中，选择之前配置的用于入金的 Proxpay 连接。

在 Configuration 部分中，按照 Proxpay 支持团队提供的信息输入 Product detail 字段的值。

点击 Save 创建入金方式。

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

点击 Edit 进入方式详细信息并完成以下字段：

在 Settings 选项卡中，使用 Group 下拉列表选择应包含该方式的一个或多个组。
在 Icon 字段中，指定将在 B2CORE UI 中显示为入金方式图标的图片 URL。
检查方式状态。

如果方式未激活（Enabled 字段中显示 No），请将 Enabled 下拉列表设为 Yes 以激活该方式。
在 PS Currencies 选项卡中，添加 THB。
如有需要，请在 Commissions 选项卡中为该方式配置佣金（详见如何为入金和出金方式配置佣金）。

点击 Test configuration 以验证入金方式的连接设置。

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

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

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

通过 Proxpay 添加出金方式

要添加并设置通过 Proxpay 进行出金的方式：

在 B2CORE Back Office 中，转到 System > Payout system > Payout methods。

点击页面右上角的 +Create。

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

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

选择 PaymentSystemWithdrawal 后，将显示以下字段：

在 Available account currencies 下拉列表中，选择一种或多种币种。通过 Proxpay 的出金将适用于以所选币种计价的账户。必须为这些币种配置 THB 的转换汇率。
在 Driver 下拉列表中，选择 Proxpay。
在 Connection 下拉列表中，选择之前配置的用于出金的 Proxpay 连接。

跳过 Configuration 部分，因为 Proxpay 出金方式无需任何设置。

点击 Save 创建出金方式。

Proxpay 出金方式将显示在出金方式列表中。

点击 Edit 进入方式详细信息并完成以下字段：