Skip to end of metadata
Go to start of metadata

Общая информация

ПараметрЗначение
Протокол

https://www.liqpay.ua/documentation/api/aquiring/

ID62
Версия модуля8.4x
Версия биллинга>0.95.xx
IPs54.229.105.178, 54.229.105.179, 34.255.91.122, 34.253.252.244, 54.171.60.13, 217.117.76.0/24

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

  1. Скопировать файл Liqpay.pm в папку /usr/abills/Abills/modules/Paysys/systems/
  2. Зайти в меню Настройки>Paysys>Настройки
  3. Добавить платежную систему

Зайти в меню Настройки>Paysys>Настройки контрагента  (добавить контрагента)

ПараметрЗначениеПример
PAYSYS_LIQPAY_COMMISSIONСумма дополнительной комиссии которая снимается с абонента при оплате этой системой. Сумма может указываться как в денежных единицах так и в процентном соотношении суммы оплаты. При указании процентного соотношения обязательно в конце указывать знак процента %2.75%
PAYSYS_LIQPAY_CURRENCYВалюта операций пополнения. По умолчанию UAH (Гривна). Если указан этот параметр система конвертирует оплату по курсу системыUAH
PAYSYS_LIQPAY_MERCHANT_IDID Мерчанта в системе Liqpayi75863222
PAYSYS_LIQPAY_MERCHANT_PASSПароль мерчанта в системе LiqpaysbHxabsEWbkQekkc43S
PAYSYS_LIQPAY_DESCRIPTIONОписание оплаты в поле description. Значение в процентах будет заменяться на то же поле из таблицы пользователейFIO - %FIO%
PAYSYS_LIQPAY_SUBSCRIBE

Если стоит 1, то абонент может воспользоваться услугой подписки Liqpay, сейчас работает только в ЛК

Внимание не работает вместе с PAYSYS_LIQPAY_SUBSCRIBE_TOKEN

1
PAYSYS_LIQPAY_SUBSCRIBE_TOKEN

Оплата по токену, который предоставляет Liqpay во время оплати, сейчас работает только в ЛК

Внимание не работает вместе с PAYSYS_LIQPAY_SUBSCRIBE

1
PAYSYS_LIQPAY_SUBSCRIBE_DEFAULTВсегда включен параметр подписки в ЛК1
PAYSYS_LIQPAY_URLАдрес сервера на который должна поступить оплата (если оплата должна поступить на другой биллинг)https://demo.abills.net.ua:9443/paysys_check.cgi
PAYSYS_LIQPAY_ACCOUNT_KEYПараметр по которому будет импорт с описания платежа, если платеж сделан не из лкUID
PAYSYS_LIQPAY_DESC_REGEX_PARSEПараметр для регулярного выражения для получения значение с описания платежа для импорта, используется если платежи поступает с внешних сервисов и нет транзакции в биллинге(\d+)(?!.*\d)

Настройки Liqpay

Регистрация нового магазина

Авторизируемся в LiqPay(https://www.liqpay.ua/authorization).

Кликаем по вкладке «Бизнес»: 

Переходим в "Налаштування" и заполняем "Занальні налаштування"

После этого заходим в "Активація" и пишем в контакты сапорта Liqpay, которые указаны в настройках активации

Подключение магазина

Авторизируемся в LiqPay(https://www.liqpay.ua/authorization).

Переходим в "Налаштування" далее API


Выбираем наш магазин: 

Заходим на вкладку «API» и копируем данные в системные опции системы Abills.

В PAYSYS_LIQPAY_MERCHANT_ID вносим Публичный ключ
В PAYSYS_LIQPAY_MERCHANT_PASS вносим Приватный ключ

Обратите внимание

Обратите внимание: если Вы будете проводить тестовый платёж, то Вы увидите что он не зачислится сразу возможно - из-за действия системы безопасности LiqPay.

Это связано с тем, что платежи в LiqPay сначала попадают в секцию «На проверке» - и получают соответственно статус wait_accept - а с этим статусом Order Master не зачисляет платежи (ведь деньги Вы фактически тоже ещё не получили - до проверки этого не происходит).

После проверки платежа (от 1 до 7 дней может занимать) и его зачисления - скрипт получит статус «Зачислено» (success) - и только в этом случае сработает зачисление и счёт отметится как «Оплаченный» в админ-панели.


Платеж обрабатывается - транзакция не завершена.
Закончена - транзакция завершена.
Ошибка оплаты - произошел сбой транзакции.

Подписка Liqpay

Подписка означает - абонент соглашается, что у него будет происходить регулярное списание средств за услуги с карточки.

1) Для осуществления подписки абонент должен перейти в портале абонента на страницу оплаты и выбрать платежную систему Liqpay и указать суму подписки.

2) Поставить галочку и осуществить подписку. Также тут абонент может ознакомиться с условиями подписки. 

3) Отменить подписку абонент может в пункте меню Регулярные платежи или осуществив стандартный переход на страницу оплаты Пополнить счет


Снятие денег в ручном режиме при активной подписке

Снятия происходят 1 числа месяца, только с абонентов с негативным депозитом на сумму задолженности


Для ручного снятия или теста можно запустить команду


/usr/abills/libexec/periodic monthly MODULES=Paysys LOGIN=test DEBUG=2 DATE="2021-07-01"