Available plugins

WordPress

Introduction

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

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:

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

Enter your admin area.
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.

Enter your admin area.
On the left panel select Plugins > Installed Plugins (see the figure below).
In WooCommerce Gateway Checkout plugin section click Settings.
The following page will display.
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.

Download plugin for Magento

Installation

To install Magento payment plugin, follow these steps.

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>.
Access your site using a command line interface, for example, PuTTY (external link).
Depending on the type of your hosting run the following commands (see the table below).

VPS/VDS Regular virtual hosting

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. Prefix syntax depends on the directory where PHP is installed. For example, using hyphen (`-`) may not be necessary: `php7.1`, `php7.2`, and so on. If you have any difficulties, contact your hosting technical support. `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` On a virtual hosting the last command may fail due to the limit set by your hosting provider. In this case contact your hosting technical support.

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.

Prefix syntax depends on the directory where PHP is installed. For example, using hyphen (-) may not be necessary: php7.1, php7.2, and so on.
If you have any difficulties, contact your hosting technical support.

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.

Log in to your Magento admin panel.
In the left menu select Stores > Configuration (see the figure below).
On the page menu select Sales > Payment Methods (see the figure below).
On the displayed page in the Other Payment Methods section scroll to Direct payment with credit/debit card (BPC) (see the figure below).
Click to see the list of the plugin settings (see the figure below).
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.

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

VPS/VDS Regular virtual hosting

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. Prefix syntax depends on the directory where PHP is installed. For example, using hyphen (`-`) may not be necessary: `php7.1`, `php7.2`, and so on. If you have any difficulties, contact your hosting technical support. `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` On a virtual hosting the last command may fail due to the limit set by your hosting provider. In this case contact your hosting technical support.

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

It is recommended to delete only BPC directory and its contents, because code directory as well as upper level directories (app) may contain data not related to the plugin.

Joomla!

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

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

Joomla! version	JShopping version	Download link	Instruction
3.x, 4.x	4.x	Download plugin for Joomla!	Joomla! & JoomShopping

Joomla! version	VirtueMart version	Download link	Instruction
3.x, 4.x	3.2.x	Download plugin for Joomla!	Joomla! & VirtueMart

Joomla! & JoomShopping

Installation

To install the plugin, follow these steps.

Log in to your Joomla! administrative panel.
In the left menu, select Components > JoomShopping > Install&Update.
In the opened page, click Choose file to browse for the plugin file or specify the URL for uploading the plugin file in the Upload from URL field. Then click Upload.

Wait until the upload is completed and the "Completed" message is displayed.

Configuration

To configure the plugin, follow these steps.

Login to your Joomla! administrative panel.
Go to Components > JoomShopping > Options and then select Payments.
The Payment list page will open. Click the name of the BPC plugin.
The plugin configuration page will open. The General tab contains general plugin settings. Here you can set Title - the name of the payment method the client will see while creating an order.

The Config tab contains the connection settings. The Advanced settings are related to Joomla! CMS and can be ignored.

Configure the plugin (see the table below) and then click Save & Close at the top.

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 mode	Defines plugin work mode: test or production.

Two-phase payments	Enables/disables two-phase payments.

Successsful order state	Joomla order status for a successfull payment .
Failed order state	Joomla order status for a failed payment .

Joomla! & VirtueMart

Installation

Log in to your Joomla! administrative panel.
In the top menu, select Extensions > Manage > Install.
In the opened page, click Or browse for file to browse for the plugin file or drag and drop the file to upload. Then click Upload.

Wait until the upload is completed and the "Installation of the plugin was successful" message is displayed.
In the top menu, select VirtueMart > Payment Methods.
The payment methods list will open. Click New at the top to create a new payment method.
In the opened Payment Method window configure the settings of the new payment method. In the Payment Method field select VM Payment - BPC Module.

Configuration

To configure the plugin, follow these steps.

Login to your Joomla! administrative panel.
Go to VirtueMart > Payment Methods.
In the list of payment methods click the name of the payment method that uses the BPC plugin . The configuration page will open.

Configure the plugin (see the table below) and then click Save at the top.

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 mode	Defines plugin work mode: test or production.

Two-phase payments	Enables/disables two-phase payments.

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_paypayment/src/CommercePAYPaymentApi.php:

const payApiTestUrl = 'https://dev.bpcbt.com/payment/'; - test environment.
const payApiProdUrl = ''; - production environment;

Installation

To install the plugin, follow these steps.

In the top menu select Manage > Extend (see the figure below)

The following page will open.
Click Install new module.
The following page will open.
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.
Enable Commerce PAYPayment module (see the figure below).

Configuration

To configure the payment plugin, do the following.

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

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.

Send cart data	Enable/disable sending cart data to the payment gateway. To enable this feature, contact your technical support service.

Tax system	Ignore this setting.

Payment type	Ignore this setting.

Type of goods and services	Ignore this setting.

Write log-file	Enable/disable event log.

Status	Enable/disable the plugin itself.

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

Installation

To install the payment plugin, do the following.

Log in to your site as administrator and in the side menu select Extensions > Installer.
The following page will display.
Click on Upload and naviagate to it in the standard Open-File dialog.
Wait for the installation process to finish.
In the side menu select Extensions > Extensions. In the Choose the extension type select Payments. The page will look as follows.
Next to Checkout Gateway click (Install).
Proceed to plugin configuration.

Configuration

To configure the payment plugin, do the following.

Log in to your site as administrator and in the side menu select Extensions > Extensions.
In the Choose the extension type select Payments.
Next to Checkout Gateway click (Edit).
The following page will display.
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.

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

Installation

To install the payment plugin, do the following.

Log in to your site as administrator and select Add-ons, click and select Manual installation.
In the opened Manual installation page click Local, select the downloaded archive and click Upload & install.
In the list of available plugins, find BPC and check whether it is active or not. Otherwise, activate it.
Proceed to plugin configuration.

Configuration

To configure the payment plugin, do the following.

Log in to your site as administrator and select Administration > Payment methods.
In the Payment methods page, click (Add payment method).
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.

Connection settings

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.

PrestaShop

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

Download plugin for PrestaShop

Installation

To install the payment plugin, complete the following steps:

Sign in to PrestaShop administrative panel and in the side menu select Dashboard > Improve > Modules > Module Manager.
On the page that opens, click on the Upload a module button at the top right-hand corner.
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).
Wait for the installation process to finish.
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:

Sign in to PrestaShop administrative panel and in the side menu select Dashboard > Improve > Modules > Module Manager.
Locate the BPC module and click the Configure button next to it.
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.

Download plugin for Webasyst

Preparation

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

Download the archive with Webasyst plugin (use the link above) and unpack it at any convenient location.
In the extracted archive, navigate to \upload\wa-plugins\payment\paypayment\lib\config\include.php file and open it in a text editor.
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://dev.bpcbt.com/payment/'); - test environment

Installation and Configuration

To install the payment plugin, complete the following steps:

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.
Pick PAYPayment.
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\paypayment\lib\config\include.php file. The parameter defining this is define('PAY_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.

Available plugins

WordPress

Introduction

Installation

Configuration

Magento

Installation

Configuration

Uninstallation

Joomla!

Joomla! & JoomShopping

Installation

Configuration

Joomla! & VirtueMart

Installation

Configuration

Drupal

Introduction

Before you begin

Installation

Configuration

OpenCart

Introduction

Installation

Configuration

CS-Cart

Introduction

Installation

Configuration

PrestaShop

Installation

Configuration

Webasyst

Preparation

Installation and Configuration

Contact us

Thank you!