Необходимое оборудование

Для эффективной организации приема платежей через Joys Digital необходимо, чтобы касса:

а. была оборудована 2D сканером;

б. была оборудована принтером чеков / пречеков с возможностью печати QR-кодов;
в. лицензия iiko должна быть актуальной.

Состав и настройка плагина

Основной файл плагина - Resto.Font.Api.Joys.Plugin.dll
Конфигурационный файл плагина - Resto.Font.Api.Joys.Plugin.dll.config
В конфигурационном файле преднастроены следующие параметры:
application key - ключ приложения, константа

server - адрес процессинга платежей, константа
terminal_key - ключ кассы, получается в процессе активации номера терминала


Как установить плагин Joys

Для того, чтобы получить и установить плагин Joys, необходимо быть официальным действующим клиентом IIKO [продукт лицензионный и лицензия активна]

Для получения плагина Joys Digital необходимо обратиться в компанию IIKO, сообщить ваш клиент ID [IIKO office - Администрирование - Установить лицензию - Клиент ID]

  1. Все файлы из сборки скопируйте в папку:
    C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.JoysPlugin
  2. Запустите IIKO Front - он зарегистрирует плагин

Если на этом шаге вы получаете сообщение об отсутствии лицензии или невозможности регистрации плагина iiKO Front, пожалуйста, перепроверьте, что архив с плагином вы распаковали корректно, а именно, у вас не образовалось лишнего каталога в пути до плагина.

  1. Запустите IIKO Office и настройте тип оплаты:

Наименование - Joys Digital

Название в чеке - Joys Digital

Можно комбинировать с другими типами оплат

Применять для всех категорий блюд
Печатать товарный чек
Счет выручки - Торговая выручка без учета скидок
Счет поступления денег - Денежные средства, эквайринг
Является фискальным - установить флаг
Способ оплаты - Электронный

Иногда ОС (Операционная Система) блокирует файлы плагинов, и после перезапуска IIKO Front плагин Joys Digital в Дополнениях IIKO не появляется.
В данном случае необходимо вручную пройтись по файлам плагина и разрешить их.


Язык клавиатуры по умолчанию

В ОС на кассе необходимо установить EN как язык клавиатуры по умолчанию.
Для этого кликните на иконку текущей раскладки клавиатуры в трее, выберите "Настройки языка" - кликните на "Клавиатура" и выберите Английский как метод ввода по умолчанию (пример для Win 10)

Активация платежного терминала Joys

Для того, чтобы IIKO мог принимать платежи Joys, необходимо выполнить следующие шаги:

Для того, чтобы активировать терминал, запустите iikoFront - Дополнения - Joys Активация терминала

Введите номер терминала, полученный в результате регистрации в Joys, нажмите ОК. В случае, если номер терминала был введен вами корректно, то система уведомит вас о том, что терминал успешно активирован.
Если нет - проверьте номер терминала, доступ к сети Интернет и повторите попытку снова.

Определите режим для плагина

Из дополнений выберите дополнение "Joys: Переключение режима" и установите настройку в положение "Ресторан" или "Фастфуд", эта настройка обязательна, в противном случае основной плагин Joys Digital не сможет провести платеж.
Ресторан - на каждом пречеке будет напечатан QR со счетом, который гость сможет оплатить через Joys Wallet (приложение-кошелек), кассир после получения информации о том, что заказ по определенному пречеку оплачен, закрывает стол - способ оплаты в заказе определяется автоматически как Joys Digital.

Фастфуд - на кассе в разделе Банковские карты кассир выбирает Joys Digital - далее происходит запуск сканера (сканер должен считывать QR с экрана), кассир сканирует QR кошелька с Joys Wallet (приложение-кошелек) гостя, и закрывает заказ при получении информации о проведении платежа.

Третий вариант: это Ресторан или Фастфуд?

Иногда кафе или ресторан работает следующим образом: заказ принимается на кассе, и на кассе распечатывается пречек для того, чтобы отправить его на кухню как заказ-наряд, для того, чтобы шеф или его су-шеф уже начали готовить, а оплата гостем осуществляется на кассе.
Если ваше заведение гостеприимства работает именно так, то режим для плагина Joys Digital должен быть выставлен как "Фастфуд". И это не значит, что заведение переходит в режим работы "Фастфуд". Это значит, что оплата заказов через Joys Digital будет производиться на кассе.


Тестовый платеж

Для того, чтобы проверить, что вы выполнили все настройки корректно и касса iiKO через плагин Joys Digital обращается в платежный сервис Joys Digital, выполните следующие действия на кассе:

  • "Ресторан" - на пречеке напечатан QR-код Joys Digital - этого достаточно для того, чтобы подтвердить, что обращение к платежному сервису настроено верно. Если на пречеке нет QR кода, пожалуйста, проверьте спецификацию принтера, который задействован при печати пречека, возможна ли печать QR с его помощью.
  • "Фастфуд" - создайте заказ на минимально доступную сумму, перейдите к оплате заказа, когда касса перейдет в состояние считывания карты, считайте сканером любой идентификатор (штрих-код товара, или какой-либо QR-код), например, тот, что мы предлагаем ниже

Если плагин настроен верно, то процессинг платежей Joys Digital вернет ответ, что попытка оплаты завершился с ошибкой (потому что считанный вами идентификатор отсутствует в справочнике средств платежа Joys) Далее отмените заказ. Всё, вы подтвердили, что настройки были выполнены корректно.

В каталоге Logs iiKO найдите лог плагина Joys Digital - Resto.Front.Api.JoysPlugin, его необходимо направить в службу сопровождения на почту - support@joys.digital , указав наименование организации. Таким образом, в службе сопровождения будут знать, что настройки выполнены и клиент поставлен на сопровождение в Joys Digital.

Задать вопрос

В случае, если при активации терминала или работе терминала возникают системные сообщения об ошибках или вы не можете совершить какое-либо действие на кассе, сопряженное с Joys, пожалуйста, обратитесь в службу сопровождения support@joys.digital
Плагин Joys логирует все операции, совершаемые с его помощью. При обращении в службу сопровождения, пожалуйста, предоставьте файл лога.
Он расположен в каталоге *CashServer/Logs/*Joys.Plugin.Log

О том, как провести платеж через Joys Digital описано здесь

Вы нашли ответ?