如何集成 Sticpay

登录您的 Sticpay 账户并前往 Sticpay API 部分。

配置以下设置，这是入金和出金方式在 B2CORE 中正常运行所必需的：

• 选中 Enable 复选框以启用基于 API 的支付。

• 选中 Unique order-no 复选框，以确保每笔交易均具有唯一订单号，避免重复。

• 在 Success URL 字段中，使用以下格式指定客户成功入金后将被重定向到的 URL：

  https://{your-Front-Office-URL}/en/payment/success

• 在 Failure URL 字段中，使用以下格式指定客户入金失败后将被重定向到的 URL：

  https://{your-Front-Office-URL}/en/payment/failed

• 在 Referrer URL 字段中，使用以下格式指定客户取消入金后将被重定向到的 URL（例如，您的 B2CORE UI 中的 Funds > Deposit 页面）：

  https://{your-Front-Office-URL}/en/funds/deposit

• 在 Callback URL 字段中，输入在 B2CORE Back Office 中配置该方式后，入金方式设置的 Webhooks 选项卡中生成的 webhook URL（详见在您的 Sticpay 账户中设置 webhook）。
• 选中 Plain JSON Callback 复选框，以确保回调响应采用纯 JSON 格式。
• 在 Whitelist IPs 字段中，输入允许向您的 API 发送请求的 IP 地址，以逗号分隔。
• 在 Encryption type 下拉列表中，选择 SHA256 以使用此加密方式进行请求签名和验证。与 B2CORE 集成仅支持 SHA256。

点击 Save 以应用更改。

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

点击页面右上角的 +Create。

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

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

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

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

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

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

在显示的 Credentials 部分中，配置 Sticpay 专属设置：

• 在 Interface version 下拉列表中，根据您设置的是生产环境还是测试集成，选择 Live 或 Sandbox。
• 在 API base URL 字段中，指定 https://api.sticpay.com，该地址同时用于生产和沙盒环境。
• 在 Merchant email 字段中，输入与您的 Sticpay 商户账户关联的电子邮件地址。该电子邮件可在 Account 部分中找到。
• 在 API key 字段中，输入在您账户的 Sticpay API 部分生成的 API 密钥。

点击 Save 以创建连接。

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

检查连接状态。

如果连接未激活（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 下拉列表中，选择一种或多种币种。通过 Sticpay 入金将适用于以所选币种计价的账户。
• 在 Driver 下拉列表中，选择 Sticpay。
• 在 Connection 下拉列表中，选择先前配置的用于入金的 Sticpay 连接。

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

点击 Save 以创建入金方式。

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

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

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

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

• 检查方式状态。

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

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

• 如有需要，请在 Commissions 选项卡中配置该方式的佣金（详见如何配置入金和出金方式的佣金）。

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

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

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

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

找到已配置的 Sticpay 入金方式，然后点击 Edit 进入方式详情。

前往 Webhooks 选项卡。

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

在您的 Sticpay 账户中，前往 Sticpay API 部分。

将复制的 webhook URL 粘贴到 Callback URL 字段中。

点击 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 下拉列表中，选择一种或多种币种。通过 Sticpay 出金将适用于以所选币种计价的账户。
• 在 Driver 下拉列表中，选择 Sticpay。
• 在 Connection 下拉列表中，选择先前配置的用于出金的 Sticpay 连接。

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

点击 Save 以创建出金方式。

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

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

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

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

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

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

• 如有需要，请在 Commissions 选项卡中配置该方式的佣金（详见如何配置入金和出金方式的佣金）。

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

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

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