如何通过 PSS 添加入金和出金方式

了解如何在 B2CORE 中使用 PSS 支持的支付系统添加入金和出金方式,包括配置连接和设置方式

本说明介绍如何添加使用可通过 PSS 连接到 B2CORE 的支付系统的入金和出金方式。支付系统服务(Payment System Service,PSS)是一项新的 B2CORE 服务,可提供与外部支付服务商和收银台系统的增强连接。

在 Integration > Payment systems 中,PSS-supported 列标记为 Yes 的支付系统可通过 PSS 连接。

常规流程

在 B2CORE 中添加入金和出金方式之前,请确保您已注册所选支付系统,并在该系统中拥有有效账户。

为支持通过 PSS 连接的支付系统添加入金或出金方式的流程包括两个步骤:

在 System > External connections 中配置与支付系统的连接。

如果该支付系统同时支持入金和出金,并且您计划将其用于这两种操作,则必须创建两个独立连接:一个用于入金,另一个用于出金。

详情请参阅步骤 1:如何配置与 PSS 支持的支付系统的连接。

添加将使用所选支付系统的入金或出金方式。

  • 要添加入金方式,请导航至 System > Deposit system > Deposit methods。
  • 要添加出金方式,请导航至 System > Payout system > Payout methods。

详情请参阅步骤 2:如何添加入金或出金方式。

步骤 1:如何配置与 PSS 支持的支付系统的连接

如果支付系统同时支持入金和出金,并且您打算将其用于这两种操作,则必须配置两个独立的连接:一个用于入金,另一个用于出金。

要配置与支付系统的连接:

导航至 System > External connection。

点击页面右上角的 +Create。

在 Create connection 页面中,填写以下字段:

  • 在 Name 字段中,输入连接名称。名称只能包含拉丁字母、数字、连字符和下划线。

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

  • 在 Provider 下拉列表中,选择:

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

在出现的 Driver 下拉列表中,选择要用于入金或出金方式的支付系统。

在出现的 Credentials 部分中,填写所选支付系统所需的特定连接设置。

点击 Save 创建连接。

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

检查连接状态。

如果连接未启用(Enabled 列中显示 No),请点击 Edit 按钮打开连接详情,并将 Enabled 下拉列表设置为 Yes。

点击 Save 应用更改。

现在,该连接已可用于添加入金或出金方式。

步骤 2:如何添加入金或出金方式

配置与支付系统所需的连接后,继续添加并设置入金或出金方式:

导航至 System > Deposit system > Deposit methods

或

System > Payout system > Payout methods。

点击页面右上角的 +Create。

在 Create method 页面中,填写以下字段:

  • 在 Name 字段中,输入方式名称。该名称必须唯一,并且只能包含拉丁字母、数字、连字符和下划线。

  • 在 Caption 字段中,输入方式标题。此标题将分配给 Back Office 中的方式,并将对 B2CORE UI 中的客户可见。

  • 在 Provider 下拉列表中,选择:

    • PaymentSystemDeposit — 添加入金方式。
    • PaymentSystemWithdrawal — 添加出金方式。

选择服务商后,将显示以下字段:

  • 在 Available account currencies 下拉列表中,选择一种或多种货币。该方式只能应用于以所选货币计价的账户。
  • 在 Driver 下拉列表中,选择将用于此方式的支付系统。
  • 在 Connection 下拉列表中,选择之前配置的与支付系统的连接。

指定连接后,将显示 Configuration 部分,您可能需要在其中配置该方式的其他设置。

如果显示消息 Configuration form is empty,则无需进行其他设置。

点击 Save 创建方式。

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

点击 Edit 按钮进入方式详情,并完成以下字段:

  • 在 Settings 选项卡上,选择将包含该方式的一个或多个组,例如 Crypto、Fiat 或两者。

  • 在 Icon 字段中,指定可在 支付系统 中找到的图标名称,以便在 B2CORE UI 中显示该方式的图标。要使用自定义图标,请指定要显示图片的 URL。

  • 检查方式状态。

    如果方式未启用(Enabled 字段中显示 No),请将 Enabled 下拉列表设置为 Yes 以启用它。

  • 在 PS Currencies 选项卡中添加所需货币(有关该选项卡的说明,请参阅 Deposit methods 或 Payout methods)。

  • 如有需要,请在 Commissions 选项卡中为方式配置佣金(详情请参阅如何为入金和出金方式配置佣金)。

点击 Save 应用更改。

现已在 B2CORE Back Office 中配置使用所选支付系统的入金或出金方式。

步骤 3:如何测试方式配置

要验证入金或出金方式的配置和连接设置,并确保该方式可正常运行,请使用 configuration testing,该功能可在以下情况下使用:

  • 创建方式期间
  • 编辑方式配置期间
  • 方式使用期间进行后台测试

如何手动测试方式配置

在创建方式或编辑其配置时,请使用手动配置测试,以验证方式连接和配置设置是否正确,然后再保存更改。

要测试方式配置:

导航至 System > Deposit system > Deposit methods

或

System > Payout system > Payout methods。

选择该方式并点击 Edit 以打开方式详情。

点击 Configuration 表单下方的 Test configuration 按钮,以验证方式连接和配置设置。

测试使用两个数据源执行:在 Configuration 表单中输入的信息,以及为该方式所选外部连接中指定的 Credentials。

测试结果将显示在页面上,并且可能是方式配置测试结果中列出的结果之一。

如何查看后台方式配置测试结果

成功创建入金或出金方式后,后台测试流程将自动启动。系统会按设定的时间间隔验证两个数据源:在 Configuration 表单中输入的信息,以及为该方式所选外部连接提供的 Credentials。这些检查可能产生方式配置测试结果中列出的结果之一。

与使用 Test configuration 按钮执行的手动测试不同,后台测试可以检测在创建或编辑方式时不存在、但之后因支付系统行为变化而出现的问题。

要查看后台测试结果:

导航至 System > Deposit system > Deposit methods

或

System > Payout system > Payout methods。

选择该方式并点击 Edit 以打开方式详情。

转到 Test configuration 选项卡以查看后台测试结果。

使用 Test configuration 按钮执行的手动配置测试不会影响后台测试结果,也不会显示在此选项卡中。

后台测试结果显示如下。

首次创建方式且完成 Configuration 表单(如适用)后,以及创建包含 Credentials 的外部连接时,Configuration 和 Credentials 记录都将被分配 version 1。当前版本会显示在选项卡的右下角。

New method configuration testing

每当更新 Configuration 或方式所使用外部连接中的关联 Credentials 时,系统都会自动增加相应的版本号。创建新版本后,将自动启动该版本的后台测试。因此,测试结果可能与之前的结果不同。

Updated method configuration testing

更新 Configuration 或 Credentials 后:

  • 相应版本会增加。

  • 新版本的后台测试将启动,且可能需要一些时间。

  • 之前测试的结果将变为过期:

    • 它们将被移至 Previous tests 部分。
    • 其 Relevance 值将变为 Old。

新版本的后台测试完成后:

  • 最新测试结果将成为当前结果。
  • Relevance 值将变为 Actual,表明结果对应于当前配置版本。

即使未更新 Configuration 或相应外部连接中的 Credentials 版本,后台测试结果也可能发生变化。出现这种情况的原因可能包括外部支付系统暂时不可用、外部服务 API 发生变化或测试过程中出现错误。在此类情况下,选项卡中也会显示新的后台测试结果。

方式配置测试结果

配置测试可能返回以下结果之一,表示入金或出金方式的当前状态:

  • Authorized — 已成功通过支付系统认证。支付系统账户拥有执行金融操作所需的足够权限。
Successful — Authorized
  • Available — 已成功通过支付系统认证。此状态不保证账户拥有创建入金或出金操作的权限。
Successful — Available
  • Failed — 配置测试失败。此状态包含错误代码和说明。
Failed
  • Unexpected — 出现意外的配置测试结果。此状态包含错误代码和说明。
Unexpected
  • Not implemented — 此支付驱动程序尚未实现配置测试。
Not implemented

最后更新于

本页目录