如何集成 PayRetailers

了解如何通过 PSS 将 PayRetailers 与 B2CORE 集成,以支持使用支持的货币进行入金和出金

PayRetailers 可通过 PSS 连接至 B2CORE,并支持入金和出金。

请按照以下说明配置 PayRetailers 连接,并在 B2CORE Back Office 中设置入金和出金方式。这些说明对应于通过 PSS 支持的支付系统添加方式的通用流程,但包含 PayRetailers 的特定详细信息。

在继续执行说明之前,您必须已注册 PayRetailers 并拥有有效账户。如有任何疑问,您可以查阅官方 PayRetailers 文档或联系其支持团队。

支持的货币

下表列出了通过 PayRetailers 进行入金和出金时支持的货币:

Alpha code Name Supported for deposits Supported for withdrawals
ARS Argentine peso ✔ ✔
BRL Brazilian real ✔ ✔
CLP Chilean peso ✔ ✔
COP Colombian peso ✔ ✔
CRC Costa Rican colon ✔ ✘
USD US dollar ✔ ✔
MXN Mexican peso ✔ ✔
PEN Peruvian sol ✔ ✔
RWF Rwandan franc ✔ ✘
TZS Tanzanian shilling ✔ ✘
KES Kenyan shilling ✔ ✘
NGN Nigerian naira ✔ ✘
ZAR South African rand ✔ ✘

配置 PayRetailers 连接

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

要配置 PayRetailers 连接:

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

点击页面右上角的 +Create。

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

  • 在 Name 字段中,输入连接名称。该名称必须唯一,并且只能包含拉丁字母、数字、连字符和下划线(例如,Deposits_PayRetailers 或 Withdrawals_PayRetailers)。

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

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

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

在出现的 Driver 下拉列表中,选择 PayRetailers。

在出现的 Credentials 部分中,配置 PayRetailers 专属设置:

  • 在 API base URL 字段中,指定:

    • https://api.payretailers.com — 用于生产环境
    • https://api-sandbox.payretailers.com — 用于沙盒测试环境
  • 在 Shop ID 字段中,输入 PayRetailers 分配给您账户的标识符。

  • 在 Secret key 字段中,指定您的 PayRetailers 账户中的密钥。

  • 在 Subscription key 字段中,指定您的 PayRetailers 账户中的订阅密钥。

所有这些详细信息均由 PayRetailers 在入驻过程中提供,也可以在您的 PayRetailers 账户的 Shops 部分中找到。

PayRetailers — Shops 菜单

点击 Save 以创建连接。

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

检查连接状态。

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

点击 Save 以应用更改。

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

通过 PayRetailers 添加入金方式

要添加并设置通过 PayRetailers 进行入金的方式:

在 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 下拉列表中,选择一种或多种货币。通过此方式入金将适用于以所选货币计价的账户。
  • 在 Driver 下拉列表中,选择 PayRetailers。
  • 在 Connection 下拉列表中,选择之前配置的用于入金的 PayRetailers 连接。

在出现的 Configuration 部分中,填写以下字段:

  • 在 Channel 下拉列表中,选择支付渠道:

    • Online — 用于在线支付
    • Wallet — 用于通过电子钱包支付
    • Credit card — 用于使用银行卡进行入金
    • Cash — 用于通过银行进行现金支付
  • 在 Country 下拉列表中,选择处理支付的国家/地区。

点击 Save 以创建入金方式。

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

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

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

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

  • 检查方式状态。

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

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

对于 PayRetailers 入金,用于处理入金的货币与方式 Configuration 部分中选择的国家/地区相关联。单个国家/地区可能支持多种入金货币:

  • 阿根廷 → ARS, USD
  • 巴西 → BRL, USD
  • 智利 → CLP, USD
  • 哥伦比亚 → COP, USD
  • 哥斯达黎加 → CRC, USD
  • 厄瓜多尔 → USD
  • 萨尔瓦多 → USD
  • 墨西哥 → MXN, USD
  • 巴拿马 → USD
  • 秘鲁 → PEN, USD
  • 卢旺达 → RWF, USD
  • 坦桑尼亚 → TZS, USD
  • 肯尼亚 → KES, USD
  • 尼日利亚 → NGN, USD
  • 南非 → ZAR, USD

例如,对于巴西,入金可以使用 BRL 和 USD 处理,二者都可以在 PS Currencies 选项卡中添加。

此外,还可以通过应用国家/地区限制,将该方式限制为仅在特定国家/地区使用(详见如何限制入金和出金方式的使用)。

PayRetailers 入金方式 — Settings 选项卡

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

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

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

现在已在 B2CORE Back Office 中配置 PayRetailers 入金方式。

通过 PayRetailers 添加出金方式

要添加并设置通过 PayRetailers 进行出金的方式:

在 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 下拉列表中,选择一种或多种货币。通过此方式出金将可从以所选货币计价的账户进行。
  • 在 Driver 下拉列表中,选择 PayRetailers。
  • 在 Connection 下拉列表中,选择之前配置的用于出金的 PayRetailers 连接。

在 Configuration 部分中,在 Channel 下拉列表内选择支付渠道。

点击 Save 以创建出金方式。

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

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

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

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

  • 检查方式状态。

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

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

对于 PayRetailers 出金,每种货币都与特定国家/地区严格一一对应。这意味着以某种货币进行的出金仅适用于其对应的国家/地区。因此,客户必须选择相应的国家/地区,并提供该地区所需的银行详细信息。

以下映射显示每种出金货币所对应的国家/地区:

  • 阿根廷 → ARS
  • 巴西 → BRL
  • 智利 → CLP
  • 哥伦比亚 → COP
  • 厄瓜多尔 → USD
  • 墨西哥 → MXN
  • 秘鲁 → PEN
PayRetailers 出金方式 — Settings 选项卡

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

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

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

现在已在 B2CORE Back Office 中配置 PayRetailers 出金方式。

最后更新于

本页目录