Available plugins

• WordPress
• Magento
• Drupal
• OpenCart
• BITRIX
• UMI.CMS
• CS-Cart
• Netcat
• MODX-Revolution
• PrestaShop
• Webasyst
• Tilda

WordPress

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

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).

WordPress version	WooCommerce version	Download link

| 4.x or later | 3.x |

|

Recommended WordPress version: no older than 4.8.3. For this manual the following components and versions were used: * WordPress 4.7.3 * WooCommerce 3.0

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.

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.
   
   
3. Click Upload Plugin at the top of the page.
4. 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.
Title	Name of the payment method, for example: Bank card.
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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Payments type	Enables/disables two-phase payments.
Test mode	Defines plugin work mode: test or production.
Description	Enter payment description to be displayed to the customer.
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.

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

Magento version	Download link

| 2.3.x |

|

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/BPC/BPC/<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 BPC_BPC 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 BPC_BPC 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 Direct payment with credit/debit card (BPC) (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.
Title displayed to your customer when they make their order	Name of the payment method, for example: Bank card.
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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Test mode	Defines plugin work mode: test or production.
Two-phase payments	Enables/disables two-phase payments.
Payed order status	Select the status in CMS to be assigned to a paid order.
Allowed Shipping Methods	Shipping methods the payment method can be used for.

Click Save Config.

Uninstallation

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 BPC_BPC 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 BPC_BPC 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/BPC/.

Drupal

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.

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

| Drupal version | Drupal Commerce version | Download link |

|---|---|---| | 8.x/9.x/10.x | 2.x |

| | 7.x | 1.13 | |

Installation

To install the plugin, follow these steps.

1. In the top menu select Manage > Extend and click Install new module.
   
2. In the Upload a module or theme archive to install click Choose file and specify the path to the plugin archive.
   
   Wait for the success message.
   
3. Enable Commerce RBSPaymentBerekeBank module (see the figure below).

Wait for the module to be installed.

Configuration

To configure the payment plugin, do the following.

1. In the top menu select Manage > Commerce > Configuration > Payment > Payment gateways.
   The following page will open.
   
2. Click Add payment gateway.
   The following page will open.
   
3. Select RBSPaymentBerekeBank.
4. Configure the payment plugin, referring to the table below the screenshot.

Setting	Description
Display name	Name of the payment method, for example: Bank card.
Mode	Defines plugin work mode: test or production.
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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Two-phase payments	Enables/disables two-phase payments.
Write log-file	Enable/disable event log.
Conditions	Block of settings added by Drupal Commerce itself. The settings refer to its own rules and logic for displaying the specified method of receiving funds.
Status	Enable/disable the plugin itself.

Click Save to save the settings.

OpenCart

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

OpenCart version	Download link

| 4.x |

| | 3.x | | | 2.3.x | |

Installation

To install the payment plugin, do the following.

1. Log in to your site as administrator and in the side menu select Extensions > Installer.
   The following page will display.
   
2. Click on Upload and naviagate to it in the standard Open-File dialog.
3. Wait for the installation process to finish.
   
4. In the side menu select Extensions > Extensions. In the Choose the extension type select Payments. The page will look as follows.
   
   
5. Next to 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 in the side menu select Extensions > Extensions.
2. In the Choose the extension type select Payments.
3. Next to 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.
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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Test mode	Defines plugin work mode: test or production.
Payments type	Enables/disables two-phase payments.
Order status before payment	Allows to specify what status CMS will assign to the order before the response about the successful payment is received from the payment gateway.
Order status Reversed	Select the status in CMS to be assigned to a reversed order.
Order status Refunded	Select the status in CMS to be assigned to a refunded order.
Currency code	Select the currency you plan to use or leave the default value.
Logging	Enable/disable event log.
Sort order	Allows to specify the display position in the list of payment systems when the client places an order.

Click (Save) in the upper right corner of the page.

1C-Bitrix

With this plugin for 1C-Bitrix your customers will be able to make purchases via our payment page.

Compatible editions of 1C-Bitrix

The plugin interacts with the e-Store module. The e-Store module is embedded in three 1C-Bitrix editions, so only these are compatible with the payment plugin:

• 1C-Bitrix: Small Business
• 1C-Bitrix: Business
• 1C-Bitrix: Enterprise

To check whether your 1C-Bitrix instance is compatible with the payment plugin, follow these steps.

1. At your 1C-Bitrix site select the Control Panel tab.
   
2. In the left panel click Marketplace.
   
3. In the displayed list to the right list select Platform Update.
   
4. On the displayed page scroll to the Update Server Response section and check Product edition value. Your 1C-Bitrix instance is compatible with the payment plugin if this field has one of the following values:
   • Small Business;
   • Business;
   • Enterprise.
     

Before you begin

For the plugin to interact with the payment gateway add the required connection strings to config.php:

• 'RBS_PROD_URL' => '', - production environment;
• 'RBS_TEST_URL' => 'https://3dsec.berekebank.kz/payment/', - test environment.

Installation

In this document 1C-Bitrix Small Business edition is used as an example.

To install the plugin, follow these steps.

1. Unpack the plugin archive.
2. Upload rbs.payment folder to:
   your site\bitrix\modules\.
3. At your 1C-Bitrix site select the Control Panel tab.
   
4. In the left panel click Marketplace.
   
5. In the Marketplace menu select Installed Solutions.
   
   
   Available Solutions page will open.
   
6. In the Available Solutions table scroll to Bank card payment.
7. Click the menu icon next to Bank card payment and select Install (see the figure below).
   
   If the installation is successful the following message will be displayed.
   

Configuration

Basic parameters

To configure the basic parameters of the payment plugin, follow these steps.

1. At your 1C-Bitrix site select the Control Panel tab.
   
2. In the left panel select e-Store.
   
3. In the e-Store menu select Settings > Payment systems.
   
4. On the displayed page click NEW PAYMENT SYSTEM.
   
   New payment system page will open.
   
5. Configure the basic payment parameters (see the table below).

Setting	Description
Handler	Select Payment by credit card (rbs_payment).
Handler name	Enter a name for the payment method, for example: Payment by credit card. This field does not appear in the 1C-Bitrix customer interface.
Payment system	Enter a name for the payment method, for example: Payment by credit card. The value of this field will be displayed to your customers on the payment method selection page.
Active	Checked - payment plugin enabled. Unchecked - payment plugin disabled.
Sorting index	The value in this field affects the order of the payment methods displayed to your customers. For example, there are three payment methods and their sorting index is 10, 45, and 100 correspondingly. On the payment method selection page the payment method that has sorting index 10 is placed first, 45 - second, and 100 - third. If payment methods have same sorting index, they are sorted by the value of the Payment system field.
Description	Payment method description that will be displayed to your customers.
Payment system logo	Click Add file and upload a desired logo. This logo will be displayed on the payment method selection page.
Open in new window	Checked - page for entering customer's card data will be opened in a separate browser window. Unchecked - page for entering customer's card data will be opened in the same window from which the customer proceeded with payment.
Payment type	Select Cashless.
Enable auto recalculation of payment	Only for two-phase payments. Checked - if an order was altered before changing its status to Approved, the order amount will be automatically recalculated.
Encoding	Leave blank or select utf-8 - the result will be the same.
ID	This setting is obsolete, leave it blank.

• Click Apply button.
  Payment system processor settings will appear below - proceed to processor settings configuration.

Processor settings configuration

Adjust the settings using the table below.

Setting	Description
Login	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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Test mode	Defines plugin work mode: test or production.
Page your customer will be redirected to after a successful payment	If you want your customers to be redirected to a certain page after a successful payment, follow these steps. In the dropdown list select Value. Fill in the field with the URL to which you want your customers to be redirected.
Page your customer will be redirected to after an unsuccessful payment	If you want your customers to be redirected to a certain page after a failed payment, follow these steps. In the dropdown list select Value. Fill in the field with the URL to which you want your customers to be redirected.
Automatic redirect to the form of payment	Unchecked - after placing an order, the customer will have to open the the payment page manually. Checked - after placing an order, the customer will be automatically redirected to the payment page.
Logging	Unchecked - logging disabled. Checked - logging enabled, log events are saved to \rbs.payment\log.txt.
Two Stage Payments	Enables/disables two-phase payments.
Allow Shipment	Unchecked - after an order is paid shipment must be approved manually; Checked - automatic shipment approval after an order is paid.
Unique order identifier in the store	In the first dropdown list select Order. In the second dropdown list select one of the following: Order ID; Order #.
Order price	In the first dropdown list select Order. In the second dropdown list select Order total.
Order description	In the dropdown select Value and enter order description.

• Click Save and proceed to configuration result.

Configuration result

The created payment method will be displayed in the table on the Payment systems page. If you need to change the payment plugin settings click the menu icon next to your payment method and select Modify (see the figure below).

UMI.CMS

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

Installation

To install the payment plugin, do the following.

1. Unpack the archive.
2. Copy the upload folder contents to your website directory.
3. Run the file rbspayment_install.php located in the root folder of the site in the browser: /rbspayment_install.php
4. Proceed to plugin configuration.

Configuration

To configure the payment plugin, do the following.

1. Log in to the administrative panel of your online store.
2. On the left menu click Emarket.
   The following page will display.
   
3. Click the tab Payments.
   The following page will display.
   
4. Do one of the following.
   
   • If you are configuring the plugin for the first time, click Add payment method button above the list of payment methods.
     
   • If you have already added a payment method using the UMI.CMS plugin, click the icon of editing in the line with the name of the payment method you set earlier.
     The following page will display.
     
     
5. Do the configuration.

Setting	Description
Title	Name of the payment method, for example: Bank card.
Payment type	Select (or leave selected) Payment Checkout Gateway
disabled	Disable/enable the payment method.
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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Test mode	Defines plugin work mode: test or production.
Two-phase payments	Enables/disables two-phase payments.

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

• If you edit the plugin for the first time, click Add in the lower-right corner of the page.
  
• If you edit the plugin not for the first time, click Save in the lower-right corner of the page.
  The created / edited payment method will be displayed in the list of payment methods.
  

CS-Cart

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

Installation

To install the payment plugin, do the following.

1. Log in to your site as administrator and select Add-ons, click and select Manual installation.
   
2. In the opened Manual installation page click Local, select the downloaded archive and click Upload & install.
   
3. In the list of available plugins, find BPC and check whether it is active or not. Otherwise, activate it.
   
4. 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. In the Payment methods page, click (Add payment method).
   

3. The following page will display.

   
   

Adjust the settings using the table below.

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

After the processor is selected in Processor field, the Configure tab appears next to the General tab.

Open the Configure tab and set the parameters.

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.
Password	API account password. If the plugin works in test mode, enter test password. If the plugin works in production mode, enter production password.
Test/Live mode	Defines plugin work mode: test or production.
Two-phase payments	Enables/disables two-phase payments.
Confirmed Order status	Allows to specify what status will be assigned to the order when it is completed by the CS-Cart system.
Enable logging	Enable/disable event log.

Click Create button.

NetCat

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

Installation

To install the plugin for NetCat, follow these steps.

1. Download the NetCat plugin, unpack, and copy its content to the folder where your NetCat website is installed: your_site/netcat
2. Open the NetCat admin panel and navigate to Development > Classificators
   
3. In the list that opens, locate Payment Gateway (BPC Payment) and click Add element.
   
4. On the form that opens, enter an arbitrary name in the Element name field and add nc_payment_system_rbspayment in the Added value block:
   

Configuration

To configure the NetCat plugin, follow these steps.

1. In NetCat admin panel, navigate to Modules > Payment module > Payment systems.
   
2. In the list of payment systems that opens, locate Payment Gateway (BPC Payment) and click on its gear-wheel icon. The settings page will open.
   
3. Type in the field values considering their description in table below.

Setting	Description
userName	API login provided by your bank.
password	API password provided by your bank.
test_mode	Possible values: yes, no. Defines whether the plugin works in test mode (yes) or production mode (no). Note that login and password for test and production may differ.
two-stage	Possible values: yes, no. Defines the payments type: one-stage (no) or two-stage (yes).
successUrl	URL of the page where the user is redirected after a successful payment.
failUrl	URL of the page where the user is redirected after a failed payment.
send_order	Possible values: yes, no. Defines whether the shopping cart will be sent to payment gateway or not. The recommended value is no; contact your technical support service for details.
taxSystem	Ignore this setting.
paymentMethod	Ignore this setting.
paymentMethod_Delivery	Ignore this setting.
paymentObject	Ignore this setting.
write_log	Possibles values: yes Defines whether to log requests to payment gateway or not.

MODX

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

Installation

To install the payment plugin, complete the following steps.

1. Download the archive with MODX plugin, unpack, and copy its content to the folder where your MODX website is installed.
2. In MODX administrative panel, go to Extras > miniShop2 > Settings > Payments and click Create.
   
3. Fill in the fields on the form that opens. Enter RBS in Handler class. Make sure to check the Active checkbox to enable the payment method.

Configuration

To configure the plugin, open the config.rbs.php file.
Type the parameter values using the table below.

Setting	Description
RBS_MERCHANT_LOGIN	API login provided by your bank.
RBS_MERCHANT_PASSWORD	API password provided by your bank.
RBS_TEST_MODE	Possible values: true, false. Defines whether the plugin works in test mode (true) or production mode (false). Note that login and password for test and production may differ.
RBS_TWO_STAGE	Possible values: true, false. Defines the payments type: one-stage (false) or two-stage (`true).
RBS_SUCCESS_URL	URL of the page where the user is redirected after a successful payment.
RBS_FAIL_URL	URL of the page where the user is redirected after a failed payment.

Listed above are the main parameters. The additional parameters below are related to taxation and shopping cart and can be ignored as long as RBS_SEND_ORDER is set to false (which is the recommended default). If needed, contact your technical support regarding these parameter values.

Setting	Description
RBS_SEND_ORDER	Possible values: true, false. Defines whether the shopping cart will be sent to payment gateway or not. The recommended value is false; contact your technical support service for details.
RBS_TAX_SYSTEM	Ignore this setting.
RBS_VAT_RATE	Ignore this setting.
RBS_FFD_PAYMENT_METHOD	Ignore this setting.
RBS_FFD_PAYMENT_DELIVERY	Ignore this setting.
RBS_PAYMENT_OBJECT	Ignore this setting.

IMPORTANT. For the plugin to interact with the payment gateway, specify the payment gateway URLs provided by your bank in lines 71 and 72 of config.rbs.php configuration file, like this: define('RBS_PROD_URL' , 'https://exampleproductionurl.com'); define('RBS_TEST_URL', 'https://3dsec.berekebank.kz/payment/');

PrestaShop

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

PrestaShop version	Download link

| 1.7.x |

|

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 > Module Manager.
2. On the page that opens, click on the Upload a module button at the top right-hand corner.
   
3. Drag and drop the downloaded archive 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 > Module Manager.

2. Locate the BPC module and click the Configure button next to it.

   
   

3. The module configuration page will open.

   
   

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.
Keep a log of requests	Defines whether the log of requests is saved (YES) or not (NO). The logs are saved in PrestaShop logging folder and can be accessed by the administrator only.

Webasyst

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

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\paypayment\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('PAY_PROD_URL', 'https\\productionURLprovidedByBank'); - production environment
• define('PAY_TEST_URL', 'https://3dsec.berekebank.kz/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 PAYPayment.
   
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

Tilda

With this plugin for Tilda your customers will be able to make purchases via our payment page. In order to connect the Bank's payment system in Tilda, complete the following steps:

• Open the Tilda projects page. Select the project (site) to which you want to add a payment system. Next, select Site Settings and open the Payment Systems tab.
  

• You need to select Bereke.
  To start accepting payments on the site, enter Login-API and Secret for order signature. These were issued to you when you registered with the payment gateway.
  

Note that Bank's payment system operates in two modes: test and production.

Test mode – intended for debugging. In this mode, only test payments are made without actual debiting of funds. To enable test mode, you need to uncheck the "Disable test mode" checkbox in the Test mode section at the bottom of the page.

Production mode – this is the primary operational mode of the store. In this mode, real payments are made with real funds debited. To enable production mode, check the Disable test mode checkbox in the Test mode section.