Ссылка скопирована

Настройка интеграции и использование платежных POS-терминалов в МедЛоке

Для работы с эквайрингом в МедЛоке необходимо:

  1. Установить браузерное расширение
  2. Настроить работу с расширением
  3. Подключить эквайринг в МедЛоке

Установка браузерного расширения

Для работы с эквайрингом необходимо установить браузерное расширение.

Рекомендованные операционные системы:

  • Windows 10 и выше;
  • Linux deb-based:
    • Ubuntu: 16.04(LTS), 18.04(LTS), 20.04(LTS), 21.04, 21.10;
    • Debian: 9, 10, 11;
  • Linux rpm-based:
    • Red Hat, CentOS : 7, 8Li;
Важно! Для MacOS расширение заблокировано. Детальнее о системных требованиях можно узнать на официальном сайте расширения.

Расширение можно установить на следующие браузеры:

Далее рассмотрим подключение на примере браузера Google Chrome. Перейдите в интернет-магазин Chrome и установите расширение «kkmserver.addin» по клику на кнопку «Установить».

Расширение в Хром для KKM

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

Открытие расширения KKM

Нажмите «Установить компоненту» и скачайте дистрибутив с программой, установите программу себе на компьютер.

Если дистрибутив не скачивается из расширения, его можно скачать также с официального сайта в разделе «Скачать программу».

Settings-LoadAddIn

Подтвердите установку, нажав «Выполнить в любом случае».

Settings-RunAddIn

Далее следуйте указаниям установщика.

Настройка расширения

Важно! Интеграция осуществляется только с теми устройствами, которые подключаются к ПК по USB или по Wi-Fi, если терминал работает через него. При подключении POS-терминала по Wi-Fi необходимо также уточнить у банка IP-адрес и IP-порт терминала.
POS-терминал не будет работать отдельно без подключения онлайн-кассы.
  1. Убедитесь что ваш POS-терминал соответствует поддерживаемым устройствам и сотрудник банка установил на ваш ПК необходимые драйверы оборудования.
  2. Выполните физическое подключение терминала к компьютеру по USB.
  3. Запустите установленную программу, обычно она называется «kkmserver».

В браузере, для активации расширения, нажмите на иконку расширения справа сверху и кликните «Настроить».

В случае, если страница настройки не открывается, в меню над полями User и Pass выберите «Встроенный сервер ККТ».
Также необходима включенная программа «kkmserver».

settings

Перейдите в раздел «Настройка оборудования» и нажмите «Добавить устройство» слева внизу (или на открывшейся странице вверху).

image-2025-3-4_8-32-44

На открывшейся странице в поле «Тип устройства» выберите «Эквайринговый терминал», затем в поле «Протокол устройства» выберите нужный протокол из списка (какие протоколы поддерживаются в интеграции с МедЛоком, перечислено ниже). После нажмите «Добавить устройство» в центральной части окна. 

image-2025-3-4_8-34-9

POS-терминалы интегрируются не с конкретными моделями, а с протоколами, которые указаны выше. При выборе терминала обратите внимание на протокол, через который он работает.

Поддерживаемые протоколы:

  • Протокол TTK2: Эквайринговые терминалы:
    Все эквайринговые терминалы которые поддерживает протокол TTK2
  • Протокол СБРФ: Эквайринговые терминалы:
    Все эквайринговые терминалы которые поддерживает Сбербанк-РФ
  • Протокол INPAS: Эквайринговые терминалы:
    Эквайринговые терминалы INPAS (Verifone, IRAS, PAX)
  • Протокол UCS: Эквайринговые терминалы:
    Эквайринговые терминалы UCS (United Card Services)
  • Протокол ARCUS-2: Эквайринговые терминалы:
    Эквайринговые терминалы ARCUS-2 (Ingenico)
  • Протокол СПБ Сбербанк:
    Система быстрых платежей (СБП) по QR коду из приложения на телефоне
  • Протокол СПБ Тинькофф (Beta):
    Система быстрых платежей (СБП) по QR коду из приложения на телефоне

Далее необходимо подключить расширение с терминалом к МедЛоку.

Подключение эквайринга в МедЛоке

Важно! Не забудьте запустить программу KkmServer.
Подключение через МедЛок потребуется произвести на каждом компьютере, с которого планируется проводить оплату.

Чтобы настроить подключение зайдите в модуль «Касса», нажмите «Настройка».

Настройка кассы эквайринг

Далее в разделе «Дополнительно» выберите пункт «Эквайринг» и нажмите «Подробнее».

Выбор эквайринга в кассе

В меню настройки нажмите «Подключить». Будет проведена проверка настроек расширения и терминала.

Настройка эквайринга

В случае, если установка и настройка расширения были проведены корректно - появится соответствующее окно. Если нет - появится ошибка, сообщающая причину, вот некоторые возможные причины:

Ошибки подключения Эквайринга

После успешного прохождения проверки появится новое окно. Для подключения у вас на балансе МедЛока должно быть не менее 500₽.

Модалка подключения эквайринг

Нажмите «Подключить». С вашего баланса будет списано 500₽ за лицензию на один месяц.

Важно! Перед нажатием на «Подключить» проверьте корректность ИНН.

В случае, если средств балансе МедЛока хватает - появится экран успешного подключения и деньги спишутся, а также появится информация о следующем платеже за лицензию.

Успешно подключенный эквайринг

Эквайринг подключён, далее необходимо добавить ИНН подключенного филиала в настройки браузерного расширения KkmServer.

Для этого в разделе «Активные лицензии» скопируйте ИНН.

Активные лицензии

На браузерном расширении выберите «Настроить».

settings

В расширении в левом меню выберите «Настройка оборудования», выберите ваш подключенный терминал из списка оборудования:

Выбор терминала

В поле «INN организации эквайринга» вставьте скопированный ИНН филиала, после нажмите «Сохранить».

Ввод INN организации в kkmserver

Настройка завершена, Эквайринг подключен и готов к работе.

Управление лицензиями

Информация об активности лицензии и дате следующего платежа всегда выводится в разделе «Активные лицензии». Платеж по эквайрингу производится автоматически каждые 30 дней.

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

Активные лицензии

Если необходимо удалить лицензию, в разделе «Активные лицензии» нажмите «Удалить» напротив нужной лицензии.

Удалить лицензию
Важно! Эквайринг на всех компьютерах и терминалах, использующий эту лицензию, перестанет работать.
Средства за неиспользованный период не возращаются.
Подтверждение удаления лицензий

После нажатия на «Удалить» восстановить лицензию не получится.