"Модуль - Оплаты и рассрочки Приват 24 и LiqPay" documentation

Overview

Compatibility

Available add-on version	CS-Cart/Multi-Vendor compatible versions
`v1.11.1`	4.13.3 – 4.17.2
`v1.10.1`	4.12.1 – 4.13.2
`v1.7.0`	4.11.4 – 4.15.2
`v1.4.1`	4.9.3 – 4.11.3
`v1.4.0`	4.3.4 – 4.9.2

Add-on is compatible with the following Themes:

YoupiTheme (compatible with correspond CS-Cart version);
UniTheme2 (compatible with correspond CS-Cart version);
Responsive.

Support

General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).

In order to use our technical support, you need to:

Log in with your order owner account on https://cs-cart.alexbranding.com;
Go to the page My Account → Orders;
Find the corresponding order with the problem add-on in the orders list and pass to its details;
Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.

If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.

Technical support by telephone calls and direct e-mails is not provided. Any help comes through tickets and helpdesk. Carefully learn documentation and technical support conditions before creating a request.

Demo

You can test the addon work with admin access using our demo server Demos for CS-Cart solutions from Alexbranding by choosing it in Addons list or just follow the link.

Restrictions and warnings

We recommend to note general restrictions:

All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
Addon files may have a closed (encoded) part, in which only a license check is located;
The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.

Usage

Installation

After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered add-ons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).

Then follow the steps below, which differs depending on your version of the CS-Cart platform:

If you have CS-Cart 4.16.1 and newer version

If you have CS-Cart 4.13.1 and newer version

If you have CS-Cart 4.12. *

If you have CS-Cart 4.11.5 and an earlier version

You can also install the add-on with a standard installation for CS-Cart. To do this, download the appropriate archive with an add-on version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered add-on. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Downloaded add-ons and in the gearwheel menu select Manual installation).

Service add-on AB: Add-ons Manager must be installed and have Active status.

Settings

Настройки модуля

1. Учет стоимости доставки при рассрочках

Work with functionality

Добавление способа оплаты "LiqPay"

1. LiqPay registration

2. Добавление способа оплаты "Приват24 и LiqPay"

1. Настройки вкладки "Настроить"

2. Возможные способы оплаты на вкладке "Настроить"

3. Настройки "Карта статусов"

Добавление способа оплаты "Оплата частями"

1. Общая информация о способах оплаты

Сервис Оплата частями ‒ это способ кредитования, которое дает возможность покупателю купить товар прямо сейчас.

Существует 4 вида сервиса:

Оплата частями ‒ комиссия за сервис берется с магазина, сумма покупки сразу зачисляется на счет. При использовании данного типа рассрочки банк возмещает магазину стоимость товара, проданного по сервису Оплата частями, на следующий день за вычетом комиссии по сервису и комиссии по эквайрингу. Комиссия по сервису зависит от срока кредита.
Оплата частями. Деньги в периоде ‒ комиссия за сервис берется с магазина, сумма покупки зачисляется в периоде. Особенностью данной схемы является то, что комиссия по сервису фиксированная - 1,5%, но при этом стоимость товара магазину возмещается не полной суммой, а ежемесячно равными платежами.
Мгновенная рассрочка ‒ комиссия за сервис берется с покупателя. Данный тип рассрочки позволяет продавать товары без комиссии за сервис до 24-х месяцев. С магазина будет взыматься только комиссия по эквайрингу. Комиссия за сервис для покупателя составит 2,9% ежемесячно от стоимости товара.
Мгновенная рассрочка. Акционная ‒ комиссия за сервис берется с магазина и с покупателя (50/50%). Данная схема разработана специально для того, чтобы минимизировать комиссию продавца в случае продаж по сервису Оплата частями за счет введения комиссии с покупателя. При покупке по данной схеме комиссия с покупателя составит 0,99% ежемесячно от стоимости товара.

2. Регистрация Оплата частями и Мгновенная рассрочка

3. Добавление способа оплаты

1. Настройки вкладки "Настроить" [CLONE]

2. Настройки "Карта статусов"

Двухстадийная оплата [CLONE]

Отображение формулы в окне выбора способа оплаты

Запрет "Оплаты частями" по товарам

Минимальный и максимальный срок кредитования отдельно для каждого товара

Модуль АВ: Купить в кредит для Украины добавляет свою вкладку на страницу редактирования товара. На этой вкладке отдельно для каждого товара и для каждого способа оплаты от компании AlexBranding можно установить:

Доступность способа оплаты по умолчанию;
Минимальный и максимальный срок кредитования.

Если выбрано По умолчанию, тогда значение определяется соответствующей настройкой конкретного способа оплаты. Для удобства в скобках указано действующее значение из настроек способа оплаты.

Вкладка "АВ: Купить в кредит для Украины" на странице редактирования товара

Экспорт/Импорт способов оплаты

Модуль AB: Оплата Приват24 и LiqPay предоставляет возможность импорта/экспорта запрещенных для товаров способов оплат с процессором Оплата частями. Для этого перейдите на страницу Панель администратора → Администрирование → Импорт/Экспорт.
Страница импорта/экспорта

Вы можете вручную настроить экспорт/импорт каждого способа оплаты. Для этого в файле для импорта укажите следующие значения:

A (available) ‒ для значения "Доступно";
D (denied) ‒ для значения "Запрещено";
пустое поле ‒ для значения "По умолчанию".

Журнал событий с ответами от банка

Additional information

Logging

Add-on holds in storage logs of all banks engagements and interactions. You can find it with a file tree:
var/files/[id_магазина]/ab__privat24/liqpay_privat24_log.txt.

File holds the following information: payment data, order_id and array with bank replies:

Array
    (
        [0] => 05/18/2019 15:18
        [1] => 90
        [2] => Array
            (
                [action] => pay
                [payment_id] => 704183149
                [status] => sandbox
                [version] => 3
                [type] => buy
                [paytype] => privat24
            )
    )

Integrations

1. Hide order number made with the payment method "Private24 and LiqPay"

Relevant for add-ons:

Add-on Hide real order id allows to hide order number made with the payment method Private24 and LiqPay as well as change order number on generated with a template value.

2. Использование банковской системы Приват24

Relevant for add-ons:

Модуль Сredit offers for Ukraine предоставляет возможность подключать и использовать модуль от банковской системы Приват24. Модуль обеспечивает совместную работу кредитных программ и рассрочек разных способов оплаты для Украины, предлагая единую кнопку Купить в кредит на странице товара и удобный интерфейс, в котором пользователь может подобрать подходящий план рассрочки из разных способов оплаты.

3. Display static stickers at products with payment method "Private24 and LiqPay"

Relevant for add-ons:

There is an ability to create static conditions for stickers: Payment by Installments, Minimum credit term and Maximum credit term. It allows to display correspond sticker at products with Private24 payment method where processor Payment by Installments is selected.

Demo-stickers were designed for comfortable us that can be activated on the page AB: Stickers choose the menu Demo data. After that go to the editing sticker page, set conditions according to your payment method and generate links of the sticker.

How to update

To have possibility to update an add-on, you must have an active subscription period for add-on license.

AB: Add-ons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new add-on version, that is guaranteed to be compatible with your CS-Cart platform version.

Before updating, always make a full database and your store files backup (we recommend backing up using server or hosting tools).

To make updates procedure:

Go to the Administration panel → Administration → Upgrade center;
Find the appropriate update among the available updates and click the Update button;
Follow all the instructions, that will be shown during the upgrade procedure;
Clear CS-Cart cache and start using new add-on version.

If you have an earlier version of the add-on (without the Upgrade center support)

List of releases

Subscribe to our Telegram-channel to get info about new releases.

v1.11.1 from 20 December 2021

Bug fixes:
[!] On the storefront payment method was not excluded if it was disable for a specific product. Fixed.

v1.11.0 from 26 October 2021

Attention! Formula for Payment by installments and Instant installment was changed. It is recommended to change formula at the appropriate payment method.

New features and improvements:
[+] Added compatibility with the "Direct Customer-to-Vendor Payments" add-on.

Functionality changes:
[*] Changed formula for Payment by installments and Instant installment.

Bug fixes:
[!] Fixed formula of monthly payment.

v1.10.1 from 13 September 2021

Bug fixes:
[!] Multi-Vendor. On the page "Orders → All orders → Edit order" error 403 occurred when clicking "Confirm" or "Cancel" payment. Fixed.
[!] When placing the order with the payment method "Payment by installment" wrong amount of order was sent if main currency of the store was not Ukrainian hrivna. Fixed.
[!] CS-Cart Multi-Vendor. There was logical error after user's return to the marketplace when placing an order with products from two and more vendors. Fixed.

v1.10.0 from 13 Jule 2021

New features and improvements:
[+] Added add-on setting "Cost of delivery at installments". The setting defines how the cost of delivery for an order will be taken into account when placing a request for Installment plan or Payment by installments.

v1.9.0 from 16 June 2021

New features and improvements:
[+] Added compatibility with the add-on "AB: Credit offers for Ukraine" v1.1.0.
[+] Added setting "Settings → Logging → AB: Payments and installments by Privat24 and LiqPay → Bank's response". When the setting is active, information about callback processing from bank will be recorded into logging.

v1.8.0 from 27 January 2021

New features and improvements:
[+] Added compatibility with "AB: Payments" add-on.

Functionality changes:
[*] "Payments by Privat24 and LiqPay" add-on version v1.8.0 is available starting from CS-Cart version 4.12.1 or higher.

v1.7.0 from 26 November 2020

New features and improvements:
[+] Added the ability to include payment through Apple pay and Google pay in settings of LiqPay payment methods.
[+] “AB: Stickers” add-on. Added the ability to create static conditions of stickers “Payment by instalments”, “Minimum credit term” and “Maximum credit term”.
[+] "AB:Stickers” add-on. Added demo-stickers "Payment by Installments".
[+] Added compatibility with the “АВ: Hide order ID” add-on.
[+] In administration panel on the order page added the ability to confirm and decline two-step payment.
[+] On the order page in the block “Payment information” added display of payment status.

Functionality changes:
[*] If available payment methods are selected for LiqPay payment method, the appropriate setting from cabinet LiqPay will be used.

Bug fixes:
[!] Credit amount disregarded extra charge of payment method. Fixed.

v1.6.2 from 16 September 2020

Bug fixes:
[!] There was no translation for language variable ab__privat24.payparts.merchanttype.pb. Fixed.
[!] Limit of months quantity was set according to the last product in the cart when there were several products in the cart list with different months quantity. Fixed.

v1.6.1 from 21 August 2020

Bug fixes:
[!] Error occured when saving the product without created credit payment methods. Fixed.

v1.6.0 from 06 August 2020

New features and improvements:
[+] Added add-on setting "Show overpay".
[+] Added add-on setting "Show minimum payment".
[+] On the editing product page in the tab "Add-ons", section "AB: Payments by Privat 24 and LiqPay" added the ability to install minimum and maximum loan term separately for any product.
[+] Added a new setting "Monthly payment formula" to the setting of payment method with the process "Payment by installments". The formula will calculate minimum payment to display on the product page.
[+] On the storefront on the product page added display of the minimal monthly payment.

Functionality changes:
[*] On the editing product page in the tab "Add-ons", section "AB: Payments by Privat 24 and LiqPay" for the variant "by default" for payment method was specified current value of the setting "Default payment method availability" of the corresponding payment method.

Bug fixes:
[!] Error occurred when editing order with the processor "Payment by installments". Fixed.
[!] When paying through LiqPay, order status was not changed by successful. Fixed.
[!] Bank response from service "Payment by instalments" was not displayed on the editing order page. Fixed.

v1.5.0 from 30 June 2020

New features and improvements:
[+] On the product page added "Buy on credit" button. When click it the pop-up window will appear with the available credit payment methods.
[+] Added user privileges to view the menu "AB: Add-ons → AB: Payments by Privat24 and LiqPay → Help".
[+] Added processor "Payment by instalments" from PrivatBank.
[+] On the editing product page in the "Add-ons" tab added the ability to forbid payment methods with the processor "Payment by instalments" for products.
[+] Added import/export of forbidden payment methods for products with the processor "Payment by instalments".
[+] Added the ability to use two-step payment. Payments confirmation or refusal can be done from a private account of the appropriate service.
[+] Added Ukrainian language support.

Functionality changes:
[*] Setting "Test mode" was removed from the settings of payment method with the processor LiqPay in the "Set" tab. It is recommended to use test keys instead which you can find in the cabinet of the LiqPay website.

v1.4.1 from 24 June 2019

Bug fixes:
[!] Fixed bug with order sum conversion on multi-currency site;
[!] Language variables are corrected;

v1.4.0 from 11 April 2019

Feature additions:
[+] Added UpgradeCenter/Connector for the next updates;

Bug fixes:
[~] Changed api address (from liqpay.com to liqpay.ua);

v1.3 from 06 December 2018

https://cs-cart.alexbranding.com/en/ab__privat24.doc

v1.2 from 18 June 2018

https://cs-cart.alexbranding.com/en/ab__privat24.doc

v1.1 from 05 June 2018

https://cs-cart.alexbranding.com/en/ab__privat24.doc

v1.0 from 22 May 2018

https://cs-cart.alexbranding.com/en/ab__privat24.doc