如何集成 KoraPay

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

点击页面右上角的 +Create。

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

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

• 在 Caption 字段中，输入将应用于 Back Office 中该连接的标题。

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

  • PaymentSystemDeposit — 添加将用于入金方式的连接。
  • PaymentSystemWithdrawal — 添加将用于出金方式的连接。

在显示的 Driver 下拉列表中，选择：

• KoraPay — 用于入金。
• KoraPay bank account — 用于向银行账户出金。
• KoraPay mobile money — 用于通过移动支付向移动钱包出金。

在显示的 Credentials 部分中，配置 KoraPay 特定设置：

• 在 API base URL 字段中，指定 https://api.korapay.com。
• 在 Secret key 字段中，输入您的 KoraPay 账户中的密钥。
• 在 Public key 字段中，输入您的 KoraPay 账户中的公钥。

要查找您的密钥和公钥，请登录 KoraPay 账户，转到 Settings，然后打开 API Configuration 选项卡。

点击 Save 以创建连接。

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

检查连接状态。

如果连接未启用（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 下拉列表中，选择一种或多种支持入金的币种，例如 NGN、GHS、KES、XAF 和 XOF。通过 KoraPay 入金将适用于以所选币种计价的账户。
• 在 Driver 下拉列表中，选择 KoraPay。
• 在 Connection 下拉列表中，选择之前配置的用于入金的 KoraPay 连接。

在 Configuration 部分中，将 Merchant bears cost 选项设置为：

• Yes — 经纪商（商户）支付交易手续费。
• No — 交易者（客户）支付交易手续费。

点击 Save 以创建入金方式。

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

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

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

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

• 检查方式状态。

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

• 在 PS Currencies 选项卡上，添加所需币种。要使该方式能够处理特定币种的入金，请确保已在此选项卡中添加该币种。

• 如有需要，可在 Commissions 选项卡上配置该方式的佣金（详情请参阅如何为入金和出金方式配置佣金）。

点击 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 下拉列表中，选择一种或多种币种。通过 KoraPay 出金将适用于以所选币种计价的账户。

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

  • KoraPay bank account — 用于向银行账户出金。

    仅支持向尼日利亚银行账户出金。

  • KoraPay mobile money — 用于通过移动支付向移动钱包出金。

    支持向肯尼亚 (KES)、加纳 (GHS)、科特迪瓦 (XOF) 和喀麦隆 (XAF) 的移动支付账户出金。

• 在 Connection 下拉列表中，选择之前配置的用于出金的 KoraPay 连接。

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

对于 KoraPay bank account 驱动程序：

• 在 Merchant bears cost 下拉列表中，选择：

  • Yes — 经纪商（商户）支付交易手续费。
  • No — 交易者（客户）支付交易手续费。

对于 KoraPay mobile money 驱动程序：

• 按照上述说明配置 Merchant bears cost 选项。
• 在 Country 下拉列表中，选择该出金方式适用的国家，例如肯尼亚、加纳、科特迪瓦或喀麦隆。

点击 Save 以创建出金方式。

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

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

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

• 在 Icon 字段中，指定 paymethod-korapay，以便在 B2CORE UI 中显示 KoraPay 出金方式的预定义图标。如需使用自定义图标，请指定要显示图像的 URL。

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

• 在 PS Currencies 选项卡上，添加所需币种。要使该方式能够处理特定币种的出金，请确保已在此选项卡中添加该币种。

• 如有需要，可在 Commissions 选项卡上配置该方式的佣金（详情请参阅如何为入金和出金方式配置佣金）。

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

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

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