如何集成 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 部分中找到。

点击 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 选项卡中添加。
此外,还可以通过应用国家/地区限制,将该方式限制为仅在特定国家/地区使用(详见如何限制入金和出金方式的使用)。
- 如有需要,请在 Commissions 选项卡中为该方式配置佣金(详见如何配置入金和出金方式的佣金)。

点击 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
- 如有需要,请在 Commissions 选项卡中为该方式配置佣金(详见如何配置入金和出金方式的佣金)。

点击 Test configuration 以验证出金方式的连接设置。
测试结果将显示在页面上。
成功验证配置后,点击 Save。
现在已在 B2CORE Back Office 中配置 PayRetailers 出金方式。
最后更新于