Инструменты страницы
1C-Bitrix
With the installed plugin for 1C-Bitrix, your customers will be able to pay with you through the payment page of «Sberbank».
The module presented in this section is installed independently by copying files to the hosting through the file manager. This module is also available from marketplace.
The version posted on the marketplace is installed through the marketplace through the Bitrix administrative part.
The program code of the two presented versions is different, but the logic of work is identical. The difference between the versions is due to different installation logic (the logic for converting encodings and copying files is different).
Compatible editions of 1C-Bitrix
Payment plugin interacts with the module Online store from 1C-Bitrix. Only three editions of 1C-Bitrix include this module and are compatible with the payment plugin:
- 1C-Bitrix: Site Management, Small Business Edition;
- 1C-Bitrix: Site management, edition «Business»;
- 1C-Bitrix: Enterprise.
For more details on the differences between editions, see the website «1C-Bitrix».
To check the compatibility of your 1C-Bitrix instance with the payment plugin, follow these steps.
- In the admin panel, select the Administration tab.
- In the left vertical pane, select Marketplace – the respective list will be displayed to the right.
- From the displayed list, select Platform update.
- On the displayed page in the section Update server response check the Product revision field value. Your copy of 1C-Bitrix is compatible with the payment plugin if the field displays one of the following values:
- Small business;
- Business;
- Enterprise.
Installation
1C-Bitrix version used for installation and configuration: 1C-Bitrix: Site Manager, Small Business Edition, version16.5.4.
To install the plugin, follow these steps.
- Unpack the plugin archive.
- On your hosting place the folder
rbs.payment
at:
<site_folder>\bitrix\modules\
. - In the top panel of 1C-Bitrix go to the Administration tab.
(If a Bitrix24 – Single Sign-On window appears, click on the Close button.) - In the left pane, select Shop.
- In the left pane, select Marketplace .
- In the menu Marketplace, select Installed solutions.
The page will be displayed: Marketplace Solutions. - In the Available solutions table find the linePayments through Sberbank.
- Click the menu icon at the beginning of the line and select Install (see image below).
- If the installation is successful, a corresponding message will be displayed (see the image below).
Configuration
Basic parameters
To configure the basic parameters of the payment plugin, follow these steps.
- In the upper panel of 1C-Bitrix, select the Administration tab.
(If a Bitrix24 – Single Sign-On window appears, click on the Close button.) - In the left pane, select Shop.
- In the menu, e-Store chooseSettings> Payment systems.
- On the page that appears, click the buttonNew payment system.
The New payment system page will be displayed.
In the 1C-Bitrix interface, a «payment system» is a payment method that a customer can choose, for example: «in cash to a courier», «by bank card», etc. The term «payment method» is used throughout this description.
- Configure the basic parameters of the payment method, referring to the table below.
The order of fields and settings may differ depending on the edition of your 1C-Bitrix instance.
Configuration Description Handler Select the Sberbank (payment) item in the list. Handler name Enter a title for the payment method, for example Payment by credit card («Sberbank»). This field is not displayed in the 1C-Bitrix interface. Name Enter the name of the payment method, for example Payment by credit card – the value of this field will be displayed to the buyer on the page for choosing a payment method. Active - The checkbox is checked – the payment plugin is enabled.
- The checkbox is not selected – the payment plugin is disabled.
Sorting The value of this field affects the position of the payment method on the payment method selection page along with payment. For example, if there are three payment methods with Sorting values of 10, 45 and 100 respectively, then the payment method 10 will be the first, 45 – the second, and 100 – the third.
If different payment methods have the same values in this field, sorting occurs by the value of the Name field.Description Payment method description – the value of this field will be displayed to the buyer on the payment method selection page. Payment system logo Click on the Add file button and specify the path to the payment method logo – this logo will be displayed to the buyer on the payment method selection page. Open in a new window - The checkbox is selected – the page for entering bank card data will be opened in a separate window of the buyer's browser.
- The checkbox is not selected – the page for entering bank card data will be displayed in the same browser window from which the buyer proceeded to pay.
Payment type Select the value Cashless from this list. Enable auto-recalculation of payments This setting is valid only for two-phase payments. If before the order went into the state Approved, its composition has changed, then when the checkbox is selected, the order amount will be automatically recalculated. Encoding - If your instance of 1C-Bitrix is installed in Windows-1251 encoding, select windows-1251 in the list.
- If your 1C-Bitrix instance is installed in UTF-8 encoding, leave blank or select utf-8.
Code This field is not used – leave it blank.
- Click on the Apply button.
The content of the section will be displayed at the bottom of Payment system processor settings section. Go to the handler setup procedure below.
Setting up the handler
Section Payment system processor settings can contain 3 tabs with the same settings:
- Default – the settings on this tab can be extended to the processing of payments of individuals and legal entities;
- Individual – allows you to override the default settings for payments to individuals (or set the settings if the default settings are not defined);
- Entity – allows you to override the default settings for payments for legal entities (or set the settings if the default settings are not defined).
In this description, the setting is shown using the example of the Default tab. If the tabsIndividual and Entity have not been edited before, the changes made will apply to these tabs.
- Configure the settings using the table below.
Configuration Description Allow shipment If checked, then after successful payment the order will be automatically allowed to be shipped. Logging Allows you to enable or disable event logging.
Test mode - If the plugin is running in test mode, in the respective fields (Login and Password) you should specify the data of the test service account.
- If the plugin works in the live mode, in the respective fields (Login and Password) you should specify the data of the live service account.
Password The password for the service account in the payment gateway.
If the plugin is running in test mode, you should specify the password for the test user account. If the plugin is running in standard (production) mode, you should specify the password for the production user account.
Two Stage Payments Allows you to set the staging of payments – payments can be one-phase (do not require confirmation from the merchant) or two-phase (for the successful completion of the payment, the merchant must complete it, before that the funds will be held on the buyer's account).
Login Login of a service account in a payment gateway with a suffix -api.
If the plugin is running in test mode, you should specify the login for the test user account. If the plugin is running in production mode, you should specify the password for the production user account.
Bank issues receipt Allows you to choose whether the shopping cart will be sent and whether a sales receipt will be generated. To be able to use this functionality, please contact your bank representative. For more details see section on compliance with law 54-FZ.
Automatic redirect to the payment form The customer will be immediately redirected to the payment form after the order is created. Fiscal documents format The list allows you to specify the used format of fiscal documents, the following options are available:
- FFD 1.0
- FFD 1.05
The format of the version must match the format selected in the personal account of the bank and in the account of the fiscalization service.
Payment type Payment type. Possible values:
- Full pre-payment before the delivery date of the payment object.
- Partial pre-payment before the delivery date of the payment subject.
- Advance payment.
- Full payment at the time of transfer of the subject of payment.
- Partial payment for the settlement item at the time of its transfer with subsequent payment on credit.
- Transfer of the subject of payment without payment at the time of its transfer with subsequent payment on credit.
- Payment for the subject of the settlement after its transfer with payment on credit.
The settings are effective only if the format of fiscal documents of version 1.05 and higher is selected.
Type of item being paid for Type of item being paid for. Possible values:
- Product.
- excisable product.
- Work.
- Service.
- Gambling bet.
- Lottery ticket.
- Intellectual property.
- Payment.
- Agent's fee.
- Several subjects.
- Other payment subject.
The settings are effective only if the format of fiscal documents of version 1.05 and higher is selected.
- Further actions depend on whether you want to override the default settings for payments made by individuals and legal entities:
- if you don't want to override the default settings you made, click Save and go to result of configuration;
- if you need to override the default settings you made, click Apply and go to the procedure for overriding default settings below.
Propagating and overriding default settings
Settings made on the Default tab are automatically propagated to tabs Individual and Entity if the latter have not been edited before. To override the default settings, follow these steps.
- Go to the Individual or Entity tab (in this description, the Individual tab is used as an example).
If you previously configured the handler on the Defaulttab, the Individual/Entity tab will look like this.
- Uncheck the box Default next to the setting you want to override and enter the desired values.
- Click on Save and skip to the tuning results below.
Result of configuration
The created payment method will appear in the table on the Payment systems page. If you need to edit the plugin parameters, click on the menu icon opposite the created payment method and select Change (see image below).