Для работы с эквайрингом в МедЛоке необходимо:
Установка браузерного расширения 
Для работы с эквайрингом необходимо установить браузерное расширение.
Рекомендованные операционные системы:
- 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 (для просмотра расширения потребуется авторизироваться в браузере)
- Firefox
- Яндекс Браузер
Важно! Если расширение недоступно - значит браузер считает, что вы находитесь не в России. Попробуйте выключить VPN и перезагрузить браузер.
Далее рассмотрим подключение на примере браузера Google Chrome. Перейдите в интернет-магазин Chrome и установите расширение «kkmserver.addin» по клику на кнопку «Установить».
После установки расширения в браузере появится дополнительная кнопка в верхнем правом углу браузера, кликните по ней и откройте расширение.
В первой строке выберите «Встроенный сервер ККТ».
Расширение установлено и готово к подключению терминала.
Настройка интеграции с POS-терминалом
Для того, чтобы подключить Эквайринг вам необходимо узнать тип подключения вашего POS-терминала:
- Терминал подключен к компьютеру по USB;
- Терминал подключен к сети Wi-Fi (переносной);
- Терминал подключен к сети по SIM-карте (переносной).
В зависимости от типа подключения необходимо уточнить различные данные у банка, обслуживающего ваш терминал.
Если терминал подключен к компьютеру по USB, уточните у банка:
- На каком эквайринговом протоколе работает ваш терминал (список поддерживаемых протоколов описан ниже);
- Является ли терминал интеграционным? (Терминал должен иметь возможность быть интегрирован с ПО kkmserver);
- Установлены ли на ваш ПК драйвера вашего терминала (устанавливаются сотрудником банка при первом подключении терминала).
Если терминал интеграционный, работает на поддерживаемом протоколе и все драйвера установлены - перейдите к разделу настройки интеграции с терминалом.
Если данных недостаточно, вы не сможете подключить терминал. У МедЛока нет возможности узнать данные о вашем терминале.
Если терминал подключен к компьютеру по Wi-Fi, уточните у банка:
- На каком эквайринговом протоколе работает ваш терминал (список поддерживаемых протоколов описан ниже);
- IP-адрес терминала;
- Порт терминала;
- Является ли терминал интеграционным? (Терминал должен иметь возможность быть интегрирован с ПО kkmserver).
Важно! В случае подключения терминала, работающего по Wi-Fi, подключение по MAC-адресу не поддерживается.
Если терминал интеграционный, работает на поддерживаемом протоколе, вы знаете IP-aдрес и порт, а также все драйвера установлены - перейдите к разделу настройки интеграции с терминалом.
Если данных недостаточно, вы не сможете подключить терминал. У МедЛока нет возможности узнать данные о вашем терминале.
Интеграция с терминалами, которые используют SIM-карту не поддерживается.
Поддерживаемые терминалы:
Список будет дополняться по факту успешного подключения того или иного терминала.
- Альфа-банк:
- PAX S300, PAX Q25, PAX D230, UniTodi P8, UniTodi p8 Bio, Kozen P12.
- СберБанк:
- Kozen P12.
- Другие банки:
- Терминалы с поддерживаемыми протоколами
Поддерживаемые протоколы:
- Протокол TTK2:
Все эквайринговые терминалы которые поддерживает протокол TTK2 - Протокол СБРФ:
Все эквайринговые терминалы которые поддерживает Сбербанк-РФ - Протокол INPAS:
Эквайринговые терминалы INPAS (Verifone, IRAS, PAX) - Протокол UCS:
Эквайринговые терминалы UCS (United Card Services) - Протокол ARCUS-2:
Эквайринговые терминалы ARCUS-2 (Ingenico) - Протокол СПБ Сбербанк:
Система быстрых платежей (СБП) по QR коду из приложения на телефоне - Протокол СПБ Тинькофф (Beta):
Система быстрых платежей (СБП) по QR коду из приложения на телефоне
Настройка интеграции терминала с расширением kkmserver
Подключите ваш POS-терминал к ПК по USB и включите его. Если терминал работает по Wi-Fi, ваш компьютер должен быть подключен к той же сети. Терминал должен быть уже настроен сотрудником банка.
Убедитесь что ваш POS-терминал соответствует поддерживаемым протоколам выше и сотрудник банка установил на ваш ПК необходимые драйвера оборудования. Без этого интеграция работать не будет.
В браузере, для активации расширения, нажмите на иконку расширения справа сверху и кликните «Настроить», откроется новая вкладка с настройками.
Перейдите в раздел «Настройка оборудования» и нажмите «Добавить устройство» слева внизу (или на открывшейся странице вверху).
На открывшейся странице в поле «Тип устройства» выберите «Эквайринговый терминал», затем в поле «Протокол устройства» выберите протокол, по которому работает ваш POS-терминал. После нажмите «Добавить устройство» в центральной части окна.
Важно! Номер устройства должен быть первым. Если у вас уже добавлена, например, касса, и терминал добавляется вторым, то интеграция работать не будет. Первым в списке оборудования должен стоять терминал.
Если у вас терминал СберБанка, обязательно проверьте, есть ли у вас на диске С папка sc552. Если папка находится в другом месте, измените путь к ней в соответствующем меню настроек терминала.
Важно! Без этой папки интеграция работать не будет. Эта папка содержит в себе драйвера терминала СберБанка. Если такой папки у вас нет - обратитесь в поддержку банка, к вам будет направлен специалист, он поможет установить и настроить все необходимое ПО.
У разных терминалов используются разные COM-порты для подключения. По умолчанию, COM-порт выбирается автоматически, но вы всегда можете самостоятельно узнать, какой именно порт используется в вашем терминале.
- Зайдите в меню Пуск на своем компьютере.
- В поисковой строке введите Диспетчер устройств и откройте его.
- Раскройте вкладку Порты (COM и LPT).
- Найдите ваш терминал, возле него будет описано, какой именно порт он использует.
Если COM-порт автоматически был указан неверно - измените его в настройках терминала на корректный из Диспетчера устройств.
Если POS-терминал подключен по Wi-Fi, необходимо изменить тип подключения на «Сеть: Ethernet/Wifi SmartSale» и заполнить поля «IP адрес/имя хоста» и «IP: порт».
Эта данные необходимо узнать у поддержки банка, обслуживающего ваш терминал.
Далее необходимо подключить расширение с терминалом к МедЛоку.
Подключение эквайринга в МедЛоке
Чтобы настроить подключение зайдите в модуль «Касса», нажмите «Настройка».
Далее в разделе «Дополнительно» выберите пункт «Эквайринг» и нажмите «Подробнее».
В меню настройки нажмите «Подключить». Будет проведена проверка настроек расширения и терминала.
В случае, если установка и настройка расширения были проведены корректно - появится соответствующее окно. Если нет - появится ошибка, сообщающая причину, вот некоторые возможные причины:
После успешного прохождения проверки появится новое окно. Для подключения у вас на балансе МедЛока должно быть не менее 500₽.
Нажмите «Подключить». С вашего баланса будет списано 500₽ за лицензию на один месяц.
Важно! Перед нажатием на «Подключить» проверьте корректность ИНН.
В случае, если средств балансе МедЛока хватает - появится экран успешного подключения и деньги спишутся, а также появится информация о следующем платеже за лицензию.
Эквайринг подключён, далее необходимо добавить ИНН подключенного филиала в настройки браузерного расширения kkmserver.
Для этого в разделе «Активные лицензии» скопируйте ИНН.
На браузерном расширении выберите «Настроить».
В расширении в левом меню выберите «Настройка оборудования», выберите ваш подключенный терминал из списка оборудования:
В поле «INN организации эквайринга» вставьте скопированный ИНН филиала, после нажмите «Сохранить».
Настройка завершена.
Чтобы проверить настроенную интеграцию, вы можете создать любой приём с любым тестовым пользователем, выбрать любую услугу, изменить ей стоимость на минимальную и начать визит, после чего нажать «Оплатить».
При оплате «Картой» или «Наличными + картой» нажмите «Отобразить сумму на терминале», сумма должна появиться на терминале.
Приложите карту к терминалу, оплата должна пройти успешно.
Эквайринг подключен, протестирован и готов к работе.
Важно! Не забудьте сделать возврат оплаченного 1₽.
Для возврата перейдите в настройки расширения.
Перейдите в раздел «История операций», выберите нужную операцию и нажмите «Вернуть» и приложите карту к терминалу, которой производили оплату.
Управление лицензиями
Информация об активности лицензии и дате следующего платежа всегда выводится в разделе «Активные лицензии». Платеж по эквайрингу производится автоматически каждые 30 дней.
В случае, если средств на балансе недостаточно, функциональность будет автоматически отключена. Для продолжения работы необходимо будет подключить эквайринг заново.
Если необходимо удалить лицензию, в разделе «Активные лицензии» нажмите «Удалить» напротив нужной лицензии.
Важно! Эквайринг на всех компьютерах и терминалах, использующий эту лицензию, перестанет работать.
Средства за неиспользованный период не возращаются.
После нажатия на «Удалить» восстановить лицензию не получится.