Available plugins

• WordPress
• Magento
• Joomla!
• Drupal
• OpenCart
• CS-Cart
• PrestaShop
• Webasyst

WordPress

Introduction

With this plugin for WordPress your customers will be able to make purchases via our payment page.

Download WordPress plugin

For this plugin to work, you have to install WooCommerce for WordPress. This plugin was tested with the following versions of WordPress and WooCommerce (see the table below).

Component	Version
WordPress	4.x and later
WooCommerce	3.x

Recommended WordPress version: no older than 4.8.3.

You can download required WooCommerce version at github.com (link to WooCommerce version history).

It is recommended to read WordPress and WooCommerce documentation:

• WordPress documentation;
• WooCommerce documentation.

For this manual the following components and versions were used:

• WordPress 4.7.3;
• WooCommerce 3.0.

WooCommerce is not compatible with all WordPress themes. In this document we use Storefront theme (external link) that was developed by WooCommerce developers.

Installation

1. Enter your admin area.
2. On the left panel select Plugins > Add New (see the figure below).
   
   The page will look as follows.
   
   
   • Click Upload Plugin at the top of the page.
   • Choose a file with the plugin you have downloaded before and click Install Now.

Configuration

To configure the payment plugin for WordPress, do the following.

1. Enter your admin area.
2. On the left panel select Plugins > Installed Plugins (see the figure below).
   
   
3. In WooCommerce Gateway Checkout plugin section click Settings.
   The following page will display.
   
   
4. Adjust the settings using the table below.

Setting	Description
Enable/Disable	Enable/disable the plugin itself.
Payed order status	Select the status for the paid order.
success_url	URL for customer redirection after a successful payment.
fail_url	URL for customer redirection after a failed payment.
Enable for shipping methods	Select shipping methods if available.

• Click Save changes.
  Notifications area will display Your settings saved.

Now you can accept payments.

Magento

With this plugin for Magento your customers will be able to make purchases via our payment page.

Download plugin for Magento

Installation

To install Magento payment plugin, follow these steps.

1. Unpack the plugin archive and upload contents of the upload folder to your site. The resulting path will be <your site>/app/code/Rbs/Rbs/<plugin files and folders>.
2. Access your site using a command line interface, for example, PuTTY (external link).
3. Depending on the type of your hosting run the following commands (see the table below).

VPS/VDS	Regular virtual hosting
Virtual private/dedicated server. Commands are run from root account. php bin/magento module:enable Rbs_Rbs php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento setup:static-content:deploy -f	Use PHP version as prefix, for example: php-7.1, php-7.2, and so on. php-7.2 bin/magento module:enable Rbs_Rbs php-7.2 bin/magento setup:upgrade php-7.2 bin/magento cache:clean php-7.2 bin/magento setup:static-content:deploy -f

Installation complete — proceed to plugin configuration.

To uninstall the plugin, follow this procedure.

Configuration

To configure Magento payment plugin, follow these steps.

1. Log in to your Magento admin panel.
2. In the left menu select Stores > Configuration (see the figure below).
   
   
3. On the page menu select Sales > Payment Methods (see the figure below).
   
4. On the displayed page in the Other Payment Methods section scroll to RBSPayment (see the figure below).
   
5. Click to see the list of the plugin settings (see the figure below).
   
6. Adjust the settings (refer to the table below).

Setting	Description
Enabled	Enable/disable the plugin itself.
Allowed Shipping Methods	Shipping methods the payment method can be used for.

• Click Save Config.

Unistallation

To uninstall Magento payment plugin, follow these steps.

1. Access your site using a command line interface, for example, PuTTY (external link).
2. Depending on the type of your hosting run the following commands (see the table below).

VPS/VDS	Regular virtual hosting
Virtual private/dedicated server. Commands are run from root account. php bin/magento module:disable Rbs_Rbs php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento setup:static-content:deploy -f	Use PHP version as prefix, for example: php-7.1, php-7.2, and so on. php-7.2 bin/magento module:disable Rbs_Rbs php-7.2 bin/magento setup:upgrade php-7.2 bin/magento cache:clean php-7.2 bin/magento setup:static-content:deploy -f

• Delete plugin files and folders from your site: app/code/Rbs/.

Joomla!

With this plugin for Joomla! your customers will be able to make purchases via our payment page. This plugin requires VirtueMart extension installed in Joomla! (external link).

Stable plugin performance is guaranteed with the following versions of Joomla! and VirtueMart. If you use other versions (for example, after Joomla! update) the plugin may perform incorrectly.

Joomla! version	VirtueMart version	Download link
3.8.x	3.x	Download plugin for Joomla!

Joomla! version	JShopping version	Download link
3.8.x	4.15.0	Download plugin for Joomla!

Before you begin

For the plugin to interact with the payment gateway add the required connection strings to rbspayment/include.php:

• define('RBS_PROD_URL', ''); - production environment;
• define('RBS_TEST_URL', 'https://dev.bpcbt.com/payment/'); - test environment.

You can download Joomla! with pre-installed VirtueMart. Filenames of archives with pre-installed VirtueMart end with Stable-Full_Package.zip. Download versions of Joomla! and VirtueMart compatible with the payment plugin.

Installation

To install the plugin, follow these steps.

1. Log in to your Joomla! administrative panel.
2. In the top toolbar select Extensions > Manage > Install (see the figure below).
   
   The page will look as follows.
   
3. Make sure that in the left menu the Install item is selected and the active tab is Upload Package File.
4. Click Or browse for filein the Upload & Install Joomla Extension section, specify the path to the plugin file, and confirm your actions.
5. If the installation is successful the following message will be displayed (see the figure below).
   
6. In the top menu click Extensions > Manage > Manage (see the figure below).
   
7. In the displayed table search for VM Payment - RBSPayment Module (see the figure below).
   
8. Check the checkbox next to this item and click Enable extension in the Status column.
9. The following message will be displayed (see the figure below).
   
10. Proceed to plugin configuration.

Configuration

To configure the plugin, follow these steps.

1. Login to your Joomla! administrative panel.
2. In the top menu select VirtueMart > Payment Methods.
   
   The following page will be displayed.
   
3. Click New button.
   The following page will be displayed.
   
4. In the Payment Name field enter a name for your payment method, for example, Online payment.
5. In the Payment Method dropdown list select VM Payment - RBSPayment Module.
   
6. Click Save at the top.
7. Select the Configuration tab of the created payment method.
   The following form will be displayed
   
8. Configure the plugin (see the table below).

Setting	Description
LOGIN-API	Your API account login. If the plugin works in test mode, enter test API login. If the plugin works in production mode, enter production login.

• Click Save & Close at the top.
• On the displayed page check the checkbox next to the configured plugin and click Publish item (see the figure below).
  

Drupal

Introduction

With this plugin for Drupal your customers will be able to make purchases via our payment page. For this plugin to work, Drupal Commerce module must be installed.

Download Drupal plugin

This plugin requires the following versions of Drupal and Drupal Commerce.

Drupal version	Drupal Commerce version
8.x	2.x

Before you begin

For the plugin to interact with the payment gateway add the required connection strings to commerce_rbspayment/src/CommerceRBSPaymentApi.php:

• const rbsApiTestUrl = 'https://dev.bpcbt.com/payment/'; - test environment.
• const rbsApiProdUrl = ''; - production environment;

Installation

To install the plugin, follow these steps.

1. In the top menu select Manage > Extend (see the figure below)
   
   The following page will open.
   
2. Click Install new module.
   The following page will open.
   
3. In the Upload a module or theme archive to install click Browse and specify the path to the plugin archive.
   Wait for the success message.
4. Enable Commerce RBSPayment module (see the figure below).
   

Configuration

To configure the payment plugin, do the following.

1. In the top menu select Manage > Commerce > Configuration > Payment gateways.
   The following page will open.
   
2. Click Add payment gateway.
   The following page will open.
   
3. Select RBSPayment.
4. To configure the payment plugin, refer to the table below.

Setting	Description
Display name	Name of the payment method, for example: Bank card.

• Click Save to save the settings.

OpenCart

Introduction

With this plugin for OpenCart your customers will be able to make purchases via our payment page.

Download plugin for OpenCart 3.x Download plugin for OpenCart 2.3.x

Before you begin

For the plugin to interact with the payment gateway add the required connection strings to system/library/rbs.php:

• private $test_url = 'https://dev.bpcbt.com/payment/'; - test environment.
• private $prod_url = ''; - production environment;

Installation

To install the payment plugin, do the following.

1. Unpack the archive.
2. Copy the upload folder contents to your website directory.
3. Log in to your site as administrator and select Extensions > Extensions.
   The following page will display.
   
4. In the Choose the extension type select Payments as shown on the figure below.
   
   The page will look as follows.
   
   
5. Next to RBSPayment Checkout Gateway click (Install).
6. Proceed to plugin configuration.

Configuration

To configure the payment plugin, do the following.

1. Log in to your site as administrator and select Extensions > Extensions.
2. In the Choose the extension type select Payments.
3. Next to RBSPayment Checkout Gateway click (Edit).
   The following page will display.
   
4. Adjust the settings using the table below.

Setting	Description
Module status	Enable/disable the plugin itself.
Currency code	Select the currency you plan to use or leave the default value.

• Click (Save) in the upper right corner of the page.
  The following message will display.

CS-Cart

Introduction

With this plugin for CS-Cart your customers will be able to make purchases via our payment page.

Download plugin for CS-Cart

Before you begin

For the plugin to interact with the payment gateway add the required connection strings to upload/app/addons/rbs_payment/Tygh/Payments/Processors/RBSPayment.php:

• protected $RBS_PROD_URL = ''; - production environment.
• protected $RBS_TEST_URL = 'https://dev.bpcbt.com/payment/'; - test environment;

Installation

To install the payment plugin, do the following.

1. Unpack the archive.
2. Copy the upload folder contents to your website directory, where CMS is installed.
3. Log in to your site as administrator and select Add-ons > Manage add-ons.
   The following page will display.
   
4. Find in the list RBSPayment and check whether it is active or not. Otherwise install it.
   
5. Proceed to plugin configuration.

Configuration

To configure the payment plugin, do the following.

1. Log in to your site as administrator and select Administration > Payment methods.
   
2. Click (Add payment method).
   The following page will display.
   
3. Adjust the settings using the table below.

Setting	Description
Name	Set a name for the payment method.
Processor	Select RBSPayment from the list.
Status	The switch button is placed at the bottom of the form. Make sure that Active is checked.

After the processor is selected in Processor field the tab Configure appears next to General settings. Go there and adjust more settings using the table below.

The following page will display.

Setting	Description
Login-API	Your API account login. If the plugin works in test mode, enter test API login. If the plugin works in production mode, enter production login.
Enable logging	Enable/disable event log.

All the other settings are not obligatory here to be filled in.

Click Create button.

PrestaShop

With this plugin for PrestaShop your customers will be able to make purchases via our payment page.

Download plugin for PrestaShop

Preparation

Before you start installation of the payment plugin, complete the following preparation steps:

1. Download the archive with PrestaShop plugin (use the link above) and unpack it at any convenient location.
2. Open the extracted rbspayment folder and open the include.php file in a text editor.
3. Specify the payment gateway URLs in lines 3 and 4 of the include.php file as shown below, then save the file and compress the rbspayment folder to archive.
   • define('RBS_PROD_URL', 'https\\productionURLprovidedByBank'); - production environment
   • define('RBS_TEST_URL', 'https://dev.bpcbt.com/payment/'); - test environment

Installation

To install the payment plugin, complete the following steps:

1. Sign in to PrestaShop administrative panel and in the side menu select Dashboard > Improve > Modules > Modules and Services.
   
2. On the page that opens, click on the Upload a module button at the top right-hand corner.
3. Drag and drop the prepared archive (see Preparation above) to the designated area of the screen (alternatively, click on select file and naviagate to it in the standard Open-File dialog).
   
4. Wait for the installation process to finish.
5. To proceed to configuration of the module right away, click Configure. You can also opt to do it later. The configuration procedure is covered in the next section.

Configuration

To configure the payment plugin, complete the following steps:

1. Sign in to PrestaShop administrative panel and in the side menu select Dashboard > Improve > Modules > Modules and Services.
   
2. Under Installed modules tab, locate the RBSPayment module and click on Configure button next to it.
   
3. The module configuration page will open at General settings tab.
   

Configure the settings on the General settings tab using the table below.

Setting	Description
Login API	API login provided by your bank.
Password	API password provided by your bank.
Test mode	Defines whether the plugin works in test mode (YES) or production mode (NO). Note that login and password for test and production modes may differ.
Payments mode	Defines the payments type: one-phase payments or two-phase payments
Default state	Order status to be shown in PrestaShop and to customers by default.
Success payment state	Order status to be shown in PrestaShop and to customers in case of successfull payment (for one-phase mode) or holding of funds (for two-phase mode).
Error payment state	Order status to be shown in PrestaShop and to customers in case of a payment error.

The settings on Other settings tab are related to taxation and shopping cart.

Setting	Description
Send cart data (including customer info)	The recommended value is NO. If this option is set to YES, order receipts will be created and sent to your customer and the Revenue Service. This is a paid option: contact your technical support service and/or Bank for details. Note that if you use it, VAT settings should be configured.
Tax System	The way taxes are accrued. Ignore this setting as long as Send cart data is set to NO.
Default VAT	VAT % used by default. Ignore this setting as long as Send cart data is set to NO.
Payment type	Attribute of a payment. Ignore this setting as long as Send cart data is set to NO.
Payment type delivery	Attribute of a payment. Ignore this setting as long as Send cart data is set to NO.
Type of goods and services	The type of item being paid for. Ignore this setting as long as Send cart data is set to NO.

Webasyst

With this plugin for Webasyst your customers will be able to make purchases via our payment page.

Download plugin for Webasyst

Preparation

Before you start installation of the payment plugin, complete the following preparation steps:

1. Download the archive with Webasyst plugin (use the link above) and unpack it at any convenient location.
2. In the extracted archive, navigate to \upload\wa-plugins\payment\rbspayment\lib\config\include.php file and open it in a text editor.
3. Specify the payment gateway URLs (provided by your bank) in lines 3 and 4 of the include.php file as shown below. Then save the file and copy the wa-plugins to \webasyst folder of your site.

• define('RBS_PROD_URL', 'https\\productionURLprovidedByBank'); - production environment
• define('RBS_TEST_URL', 'https://dev.bpcbt.com/payment/'); - test environment

Installation and Configuration

To install the payment plugin, complete the following steps:

1. Sign in to Webasyst administrative panel. Select "Store", and at the top right-hand corner click on Settings. In the side menu on the left, select Payment>Add payment option.
   
2. Pick RBSPayment.
   
3. On the page that opens, click on Configure. The plugin settings page will open.
   

Configure the settings using the table below.

Setting	Description
Enabled	Checkbox that defines whether the plugin is active or not. Should be checked for the plugin to work.
Description	Description of the plugin as seen by customer
Offer payment to customer types	Setting that governs to whom the checkout option provided by the plugin will be available to
Offer this payment method with selected shipping types	Setting that governs for what shipping types the checkout option provided by the plugin will be available for
Offer this payment method with selected shipping methods	Setting that governs for what shipping methods the checkout option provided by the plugin will be available for
Login-API	API login provided by your bank.
Password	API password provided by your bank.
Test mode	Defines whether the plugin works in test mode. Note that login and password for test and production modes may differ.
Two-phase payments	Defines the payments type: one-phase payments or two-phase payments

The settings below are related to taxation and shopping cart. They may or may not be displayed, depending on the global plugin setting in \wa-plugins\payment\rbspayment\lib\config\include.php file. The parameter defining this is define('RBS_ENABLE_FISCALE_OPTIONS', true);. Default value is true, but it can be changed to false in order to hide these settings.

Setting	Description
Send cart data (including customer info)	If this option is checked, order receipts will be created and sent to your customer and the Revenue Service. This is a paid option: contact your technical support service and/or Bank for details. Note that if you use it, VAT settings should be configured.
Tax system	The way taxes are accrued. Ignore this setting as long as Send cart data is disabled.
Default VAT	VAT % used by default. Ignore this setting as long as Send cart data is disabled.
Payment type	Attribute of a payment. Ignore this setting as long as Send cart data is disabled.
Payment type delivery	Attribute of a payment. Ignore this setting as long as Send cart data is disabled.
Type of goods and services	The type of item being paid for. Ignore this setting as long as Send cart data is disabled.