Документация Liqpay PRO

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку.

Магазины версии 3.0, 3.x Установка:

  1. Установить архив liqpaypro.ocmod.zip через Установщик модулей, в модификациях (менеджер дополнений) нажать обновить кэш модификаторов (кнопка со стрелками по кругу, в правом верхнем углу)
  2. Установить основной модуль в админ панель -> Дополнения -> Оплата -> ART&PR LiqPay PRO -> Установить (Если вы не видите модуль то воспользуйтесь установкой вручную)
  3. Установите остальные методы ART&PR LiqPay PRO по мере надобности (Внимание! убедитесь что вам доступны данные методы на стороне liqpay в личном кабинете)

Магазины версии 2.0, 2.1, 2.2, 2.3 Установка:

  1. Установить архив liqpaypro.ocmod.zip через Установщик модулей, в модификациях (менеджер дополнений) нажать обновить кэш модификаторов (кнопка со стрелками по кругу, в правом верхнем углу)
  2. Установить основной модуль в админ панель -> Дополнения -> Оплата -> ART&PR LiqPay PRO -> Установить (Если вы не видите модуль то воспользуйтесь фиксом или установкой вручную)
  3. Установите остальные методы LiqPay PRO по мере надобности (Внимание! убедитесь что вам доступны данные методы на стороне liqpay в личном кабинете)

 

Магазины версии 1.5  Установка:

  1. Скопировать все из папки Upload в корень сайта
  2. Установить основной модуль в админ панель -> Дополнения -> Оплата -> ART&PR LiqPay PRO -> Установить
  3. Установите остальные методы LiqPay PRO по мере надобности (Внимание! убедитесь что вам доступны данные методы на стороне liqpay в личном кабинете)
  4. Внимание! для полноценной работы необходим установленный и рабочий VQMOD

 

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

  1. Ввести настройки модуля: Публичный и приватный ключ (их вы можете увидеть в кабинете liqpay)
  2. На стороне liqpay в настройках магазина
    установите настройки со скриншотов
    Внимание! Устанавливать флаг POST DATA не обязательно, если вы установили данный флаг, то обязательно в настройках модуля включите post data - да и положите файл redir.php в папку liqpay_redir в корень сайта, адрес должен быть следущий /liqpay_redir/redir.php скачать файл можно по ссылке.

  3. Обязательно настройте вкладку возмещение
  4. настройте тестовый режим если это необходимо (ВНИМАНИЕ! публичный и приватный ключ у тестового режима другой)
  5. В настройках модуля выбирите тип платежей одностадийные или двухстадийные
  6. Выбирете валюту магазина соответствующею вашей валюте счета
  7. Установите разные статусы для ожидаемого и удачного платежа (РАЗНЫЕ)
  8. Установите статус включено (остальные настройки являются не обязательноми и добавляют только дополнительный функционал)

Обновление версии модуля

  1. Удалить модификатор (для магазинов 2.х)
  2. Провести полную установку с заменой файлов
  3. Ввести в настройки повторно публичный и приватный ключ
  4. Пересохранить настройки модуля
  5. Если вы корректировали tpl или twig, то произвести повторные корректировки под свой шаблон
  6. Обновить кэш twig (для магазинов 3.х, главная страница админ панели, кнопка с шестеренкой в правом верхнем углу)

Режим работы Отложенная оплата

В данном режиме оплата покупателем возможно только после обработки заказа администратором магазина
В настройках включите режим отложенная оплата, установите 3 разных статуса для статуса после заказа, разрешения оплаты и оплаченного заказа.

После заказа покупатель получит 1й статус.
Для активации оплаты, необходимо в просмотре(не редактировании) заказа установить 2й статус из настроек модуля - Статус для активации Отложенной оплаты и установить галку уведомить покупателя, нажать кнопку добавить историю
В версиях магазинов 2.х, для работы отложенной оплаты обязательно наличие модификатора в разделе Менеджер дополнений(Модификаторы) и обновленный кеш модификаторов (там же кнопка вверху стрелки по кругу)

Покупатель получит ссылку в письме о смене статуса заказа (поддерживается стандартное опенкартовское письмо о смене статуса заказа, если вы используете модуль шаблонов то ссылки может не быть) и в кабинете покупателя, если покупатель зарегистрирован появится ссылка на оплату (поддерживается стандартный шаблон кабинета)

После оплаты заказ получит 3й статус

 

Перевод модуля на другой язык

  1. Распакуйте архив модуля и отредактируйте файлы внутри admin/language/ru-ru и catalog/language/ru-ru переведя текст на Ваш язык, сохраните файлы в кодировке UTF-8 без BOM
  2. Скопируйте содержимое папки admin/language/ru-ru и catalog/language/ru-ru в папку вашего языка(например в en-gb)

 

Apple Pay и Google Pay

Для работы этих методов необходимо чтобы они были активны в кабинете liqpay в разделе checkout

 

Доступные переменные

Некоторые переменные могут не работать в зависимости от версии магазина или места вывода

~href~ - ссылка на оплату
~orderlist~ - список заказа
~paysum~ - сумма к оплате без знака валюты
~paysum-symbol~ - сумма к оплате со знаком валюты
~total-nosymbol~ - итого заказа без знака валюты
~total-symbol~ - итого заказа со знаком валюты
~order_id~ - номер заказа
~invoice_no~ - номер счета
~invoice_prefix~ - префикс счета
~store_id~ - id магазина
~store_name~ - название магазина
~store_url~ - url магазина
~customer_id~ - id покупателя
~customer_group_id~ - id группы покупателя
~firstname~ - имя
~lastname~ - фамилия
~telephone~ - телефон
~fax~ - факс
~email~ - почта
~payment_firstname~ - имя плательщика
~payment_lastname~ - фамилия плательщика
~payment_company~ - компания плательщика
~payment_address_1~ - адрес плательщика
~payment_address_2~ - адрес2 плательщика
~payment_postcode~ - индекс плательщика
~payment_city~ - город плательщика
~payment_zone_id~ - id гео зоны плательщика
~payment_zone~ - гео зона плательщика
~payment_zone_code~ - код зоны плательщика
~payment_country_id~ - id страны плательщика
~payment_country~ - страна плательщика
~payment_iso_code_2~ - iso код плательщика
~payment_iso_code_3~ - iso код плательщика
~payment_address_format~ - формат адреса плательщика
~payment_method~ - метод оплаты
~payment_code~ - код оплаты    
~shipping_firstname~ - имя для доставки
~shipping_lastname~ - фамилия для доставки
~shipping_company~ - компания для доставки
~shipping_address_1~ - адрес доставки
~shipping_address_2~ - адрес2 доставки
~shipping_postcode~ - индекс для доставки
~shipping_city~ - город доставки
~shipping_zone_id~ - id гео зоны доставки
~shipping_zone~ - гео зона доставки
~shipping_zone_code~ - код зоны доставки
~shipping_country_id~ - id страны доставки
~shipping_country~ - страна доставки
~shipping_iso_code_2~ - iso код доставки
~shipping_iso_code_3~ - iso код доставки
~shipping_address_format~ - формат адреса доставки
~shipping_method~ - метод доставки
~shipping_code~ - код метода доставки
~comment~ - комментарий
~total~ - итого (в валюте по умолчанию)
~order_status_id~ - id статуса заказа
~order_status~ - статус заказа
~language_id~ - id языка
~language_code~ - код языка
~language_filename~ - файл языка
~language_directory~ - дирректория языка
~currency_id~ - id валюты
~currency_code~ - код валюты
~currency_value~ - курс валюты
~ip~ - ip
~forwarded_ip~ - переадресованный ip
~user_agent~ - юзер агент
~accept_language~ - язык
~date_modified~ - дата изменения заказа
~date_added~ - дата создания заказа


Переменные и использование полей из Simple:
Название берется из вкладки "Настройка полей" строка ID


Для Simple 4.x
~paymentsimple4_имяполя~ - поле привязанное к адресу оплаты
~shippingsimple4_имяполя~ - поле привязанное к адресу доставки
~simple4_имяполя~ - поле привязанное к учетной записи покупателя или поле привязанное к методу

Выбор отображения отчества покупателя
Пример:
Отчество: ~simple4_otchestvo~