如何集成 B2BINPAY

在 B2CORE Back Office 中，导航至 System > External connections。

点击页面右上角的 +Create。

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

• 在 Name 字段中，输入连接名称。该名称必须唯一，并且只能包含拉丁字母、数字、连字符和下划线（例如，Deposits_B2BINPAY 或 Withdrawals_B2BINPAY）。

• 在 Caption 字段中，输入将在 Back Office 中应用于该连接的显示名称。

• 在 Provider 下拉列表中，选择：

  • PaymentSystemStaticDeposit — 添加将用于支持静态支付详情的入金方式的连接。
  • PaymentSystemWithdrawal — 添加将用于出金方式的连接。

在显示的 Driver 下拉列表中，选择 B2BINPAY V3。

在显示的 Credentials 部分中，配置 B2BINPAY 专用设置：

• 在 API base URL 字段中，指定 B2BINPAY 为您的集成环境提供的基础 URL。
• 在 Client ID 字段中，输入 B2BINPAY 提供的客户端标识符。
• 在 Client secret 字段中，输入与您的客户端 ID 关联的密钥。
• 在 Callback secret 字段中，输入用于验证来自 B2BINPAY 的回调通知的密钥。

有关详细信息，请参阅 B2BINPAY 文档中的如何访问 API。

点击 Save 以创建连接。

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

检查连接状态。

如果连接未启用（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 下拉列表中，选择 PaymentSystemStaticDeposit。

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

• 在 Available account currencies 下拉列表中，选择一种或多种货币。该方式将可用于向 B2CORE 中以此选项卡添加的货币计价的客户钱包入金。
• 在 Driver 下拉列表中，选择 B2BINPAY V3。
• 在 Connection 下拉列表中，选择先前配置的用于入金的 B2BINPAY 连接。

选择连接后，将显示 Configuration 表单。您可能会看到消息 Configuration form is temporarily unavailable.。请稍候，直至表单可用。

在 Configuration 部分中，填写以下字段：

• 在 Wallet 下拉列表中，选择将用于处理交易的 B2BINPAY 钱包。列表中每个钱包都会显示 B2BINPAY 分配的标识符、钱包类型（Merchant 或 Enterprise）、钱包货币以及标签（如已在 B2BINPAY 中指定）。

  有关详细信息，请参阅Merchant 和 Enterprise 钱包的区块链选择。

• Collect personal data 字段显示 No，且无法更改，因为此 B2BINPAY 集成目前不支持 Travel rule。

点击 Save 以创建入金方式。

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

点击 Edit 打开方式详情，并填写以下字段：

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

• 在 Icon 字段中，指定 paymethod-b2binpay，以便在 B2CORE UI 中显示该方式的预定义图标。若要使用自定义图标，请指定要显示的图像 URL。

• 在 Rates provider 下拉列表中，选择 B2BINPAY 作为处理涉及货币兑换的入金时的首选汇率提供商。为此，必须先在 Currencies > Rates 下将 B2BINPAY 添加为汇率提供商（有关详细信息，请参阅如何配置货币汇率）。

• 检查方式状态。

  如果方式未启用（Enabled 字段显示 No），请将 Enabled 下拉列表设置为 Yes 以启用它。

• 在 PS Currencies 选项卡上，添加可处理入金的货币。这些货币应为在 Configuration 部分中选择的 B2BINPAY 钱包所支持的货币。

要通过此方式启用特定货币的入金，请确保该货币已添加到 PS Currencies 选项卡中。

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

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

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

在 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 下拉列表中，选择一种或多种货币。该方式将可用于从 B2CORE 中以此选项卡添加的货币计价的客户钱包出金。
• 在 Driver 下拉列表中，选择 B2BINPAY V3。
• 在 Connection 下拉列表中，选择先前配置的用于出金的 B2BINPAY 连接。

选择连接后，将显示 Configuration 表单。您可能会看到消息 Configuration form is temporarily unavailable.。请稍候，直至表单可用。

在 Configuration 部分中，填写以下字段：

• 在 Wallet 下拉列表中，选择将用于处理交易的 B2BINPAY 钱包。列表中每个钱包都会显示 B2BINPAY 分配的标识符、钱包类型（Merchant 或 Enterprise）、钱包货币以及标签（如已在 B2BINPAY 中指定）。

  有关详细信息，请参阅Merchant 和 Enterprise 钱包的区块链选择。

• 在 Blockchain fee level 下拉列表中，选择 Low、Medium 或 High。

• 在 Force blockchain 下拉列表中（仅适用于 Merchant 钱包），选择：

  • Yes — 仅使用链上交易。
  • No — 在可能的情况下允许使用链下交易。

• Collect personal data 字段显示 No，且无法更改，因为此 B2BINPAY 集成目前不支持 Travel rule。

点击 Save 以创建出金方式。

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

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

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

• 在 Icon 字段中，指定 paymethod-b2binpay，以便在 B2CORE UI 中显示该方式的预定义图标。若要使用自定义图标，请指定要显示的图像 URL。

• 在 Rates provider 下拉列表中，选择 B2BINPAY 作为处理涉及货币兑换的出金时的首选汇率提供商。为此，必须先在 Currencies > Rates 下将 B2BINPAY 添加为汇率提供商（有关详细信息，请参阅如何配置货币汇率）。

• 检查方式状态。

  如果方式未启用（Enabled 字段显示 No），请将 Enabled 下拉列表设置为 Yes 以启用它。

• 在 PS Currencies 选项卡上，添加可处理出金的货币。这些货币应为在 Configuration 部分中选择的 B2BINPAY 钱包所支持的货币。

要通过此方式启用特定货币的出金，请确保该货币已添加到 PS Currencies 选项卡中。

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

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

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