Инструменты страницы



HostCMS

With the installed plugin for Host CMS, your customers will be able to pay with you through the payment page of Sberbank.

Download plugin for HostCMS 6.8.x



Installation

To install and configure the payment plugin for HostCMS, follow these steps.

  1. Log in to the admin panel of the site.
  2. In the left menu, select Content> Online Stores (see image below).


    The following page will be displayed.


  3. In the list Online Stores click on the link of your online store (see image below).

  4. On the displayed page, in the top menu, select References > Payment systems – see image below.


    The following page will be displayed.


  5. Click on the Add button.
    The following page will be displayed.


  6. In the General tab specify the basic settings referring to the table below.
    Configuration Description
    Name Enter the name of the payment method.
    Online Store Select the store from the list to which the payment method will belong. (If you followed the procedure, the need for the title should already be selected.)
    Description If necessary, enter a description of the payment method.
    Image If necessary, upload an image that represents a custom payment method in the store.
    Active Make sure the Active checkbox is checked.
    Handler code
    1. Open the file contained in the payment plugin archive using a text editor, for example, using Notepad.
    2. Copy and paste the contents of the file to the Handler code field.
  7. Do one of the following:
    • To complete the installation and return to configuring later, click the Save button under the payment method editing form.
    • To continue with the settings, edit the plugin code in field Handler and then click on the Save button under the payment method editing form.



Configuration

To configure the plugin for HostCMS, follow these steps.

  1. Log in to the admin panel of the site.
  2. In the left menu select Content> Online Stores.
  3. In the Online Stores list, click on the link of your online store.
  4. From the top menu select References > Payment systems.
    A list of installed payment methods will be displayed (see image below).


  5. Click on the icon next to created payment method: (Edit) – see images below.
  6. On the page displayed on the General tab, edit the plugin code in the Handler field referring to the table below.
Editing a plugin

In the plugin code, settings are represented by variables preceded by a $ sign. To change the value of a variable, enter your value without changing the format. Below are some examples.

  • If the value of a variable is enclosed in single quotes ('<value>'), leave them as is.
    ''$user_name''
  • The variable value can be expressed as a number without quotes.
    $tax_system = 0
  • The value can be boolean: true /false, also indicated without quotes. (Case is irrelevant.) 
    $two_stage = false
Configuration Description
$user_name

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.

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

$test_mode

Allows you to set the plug-in operation mode: test or live (working).

  • 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.
$two_stage

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

$send_order

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.

$tax_system

Tax system. The following values are available:

  • General;
  • Simplified, income;
  • Simplified, income minus expenses;
  • Unified tax on imputed income;
  • Unified agricultural tax;
  • Patent tax system.

This setting is applied only if you have configured fiscalization parameters – see details in section on compliance with law 54-FZ.

$ffd_version

The list allows you to specify the used format of fiscal documents, the following options are available:

  • v10 – FFD 1.0;
  • v105 – 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.

$ffd_paymentMethodType

Payment type. Possible values:

  • 1 – full pre-payment before the delivery date of the payment subject;
  • 2 – partial pre-payment before the delivery date of the payment subject;
  • 3 – advance payment;
  • 4 – full payment on the delivery date of the payment subject;
  • 5 – partial payment for the payment subject on the delivery date followed by payment on credit;
  • 6 – delivery of the payment subject on the delivery date without payment followed by payment on credit;
  • 7 – payment for the payment subject after its delivery using payment on credit.

The settings are effective only if the format of fiscal documents of version 1.05 and higher is selected.

$ffd_paymentObjectType

Type of item being paid for. Possible values:

  • 1 – product;
  • 2 – excisable product;
  • 3 – work;
  • 4 – service;
  • 5 – gambling bet;
  • 7 – lottery ticket;
  • 9 – intellectual property;
  • 10 – payment;
  • 11 – agent's fee;
  • 12 – several subjects;
  • 13 – other payment subject.

The settings are effective only if the format of fiscal documents of version 1.05 and higher is selected.


Types 6 (gambling winnings) and 8 (lottery winnings) are not used.

$logging

Allows you to enable or disable event logging.

When finished editing, click on the Save button under the payment method editing form.