Настройка ПО r_keeper

1. Если вы еще не подключили QR‑код от Яндекс Пэй и не заказали табличку с QR-кодом, выполните шаги 1–3 инструкции.

2. После того как вы выпустили токен, у вас есть два варианта настройки интеграции:

   • Вариант 1. Обратиться к дилеру — он выполнит дальнейшую настройку ПО.

     Найти своего дилера и его контакты можно на странице https://business.rkeeper.ru/dealers.

   • Вариант 2. Настроить самостоятельно.

     Если у вас есть технические специалисты, вы можете выполнить настройку ПО самостоятельно по инструкции.

3. После того как ПО будет настроено, протестируйте оплату заказа и возврат средств, чтобы проверить работу сервиса.

Самостоятельная настройка ПО

Измените следующие элементы:

• Настройки в менеджерской станции
• Настройки в конфигураторе QR-кодов от Яндекс Пэй

Настройки в менеджерской станции

Шаг 1. Настройка HTTPS сервера на кассовом сервере

1. В справочнике Сервис → Менеджерская станция → Привилегии на объекты проверьте наличие привилегии HTTP Access. В новых версиях r_keeper 7 она предустановлена. Если такой привилегии нет, создайте ее.

   

2. В справочнике Сервис → Станции и устройства выберите кассовый сервер, на котором будет настраиваться интеграция.

3. Во вкладке Свойства:

   • в разделе HTTP Ограничения укажите привилегию HTTP Access;
   • в разделе HTTP Server в поле HTTP Data port укажите свободный порт, по которому будет доступен кассовый сервер.

   

4. Дайте доступ на привилегию работнику:

   1. В справочнике Персонал → Работники выберите роль работников или создайте новую.

   2. Во вкладке Свойства в разделе Менеджерские ограничения добавьте привилегию HTTP Access.

      

   3. Для этой роли добавьте работника и установите ему пароль для менеджерской станции.

      Имя и пароль этого работника будут использоваться для авторизации на сервере через HTTPS.

Шаг 2. Добавление PDS интерфейса

1. В справочнике Сервис → Станции и устройства выберите кассовый сервер, на котором будет настраиваться интеграция.

2. Во вкладке Устройства добавьте новый PDS интерфейс:

   1. Откройте контекстное меню и выберите Список драйверов.

      

   2. В открывшемся окне выберите PDS interface и перетащите его в область устройств кассового сервера.

      

   3. На предложение связать новый PDS интерфейс и интерфейс Персональной Дисконтной Системы ответьте Нет.

3. Заполните поля PDS интерфейса:

   

   PDS Server Name	YANDEX_PAY_FARCARDS
   Call timeout	300
   Look Up Card By Mail Addr	Yes, try as card code on not found
   Pass ALL Receipts XML data	On special pays, always (fail if impossible)
   Authorize before transaction	No authorization calls
   Pass ALL Bills XML data	No

Шаг 3. Добавление нового интерфейса по взаимодействию с Яндекс Пэй

1. В справочнике Сервис → Интерфейсы добавьте новый интерфейс.

2. В созданном интерфейсе заполните поля:

   

   Название	Интерфейс Яндекс Пэй
   Статус	Активный
   Формат максимального платежа	Очистите поле (оставьте пустую строку)
   Общее имя DLL	pdsempty.dll
   Файлы библиотек (DLL) → <Название ресторана> → Сервер	Выберите PDS интерфейс, который вы добавили на шаге 2

Шаг 4. Добавление нового типа валют и валюты

Подробнее о валютах см. на сайте r_keeper в разделе Настройка Валют.

1. В справочнике Деньги → Валюты нажмите Все. Откройте контекстное меню и выберите Новый тип валют.

2. Во вкладке Свойства заполните поля:

   

   Название	QR-код от Яндекс Пэй
   Статус	Активный
   Способ оплаты	Платежная карта
   Тип фискальности	Фискальный чек

3. В созданном типе валюты откройте контекстное меню и выберите Новая валюта.

4. Во вкладке Свойства заполните поля:

   

   Название	Яндекс Пэй
   Статус	Активный
   Не в сдаче	Включите опцию
   Без сдачи	Включите опцию
   Тип фискальности	Фискальный чек
   Автозаполнение	Вся сумма
   Способ ввода доп.инфо	guid валюты
   Интерфейс	Выберите интерфейс Яндекс Пэй, который вы добавили на шаге 3

5. После добавления валюты автоматически сгенерируется значение поля Код. При необходимости измените поле вручную.

   Скопируйте значение поля Код.

6. Перейдите в справочник Сервис → Интерфейсы → Интерфейс Яндекс Пэй и вставьте скопированное значение в поле Автооплата по субсчетам:

   

Шаг 5. Настройка MCR-алгоритма

Подробнее о MCR-алгоритмах см. на сайте r_keeper в разделе Справочник MCR алгоритмы.

1. В справочнике Сервис → Обработка сигналов устройств → MCR алгоритмы добавьте новый MCR-алгоритм и заполните поля:

   

   Собственное имя	Mcr Яндекс Пэй
   Статус	Активный
   Тип алгоритма	Скрипт вер. 7.0
   Типы устройств	Включите все опции
   Область	Интерфейс
   Объект	Интерфейс Яндекс Пэй Примечание Это значение станет доступно после выбора значения Интерфейс в поле Область.
   Скрипт	Нажмите на три точки и вставьте скрипт: function MCRXXXXXXX(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean; begin Result := Parameter = '{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}'; end; В этом скрипте: Имя функции MCRXXXXXXX может быть свое для каждой базы данных. Оставьте автоматически сгенерированное значение. Вместо {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} укажите guid валюты, созданной на шаге 4.

Шаг 6. Изменение общих настроек системы

1. В справочнике Настройки → Параметры найдите параметр Оплата платежной картой и задайте ему значение Только в режиме расчета или Всегда.

2. Убедитесь, что параметр Тип чека намерения имеет значение Единый чек перед оплатой или Чек на расчет в кредит.

Настройки в конфигураторе QR-кодов

1. Запустите конфигуратор — приложение YandexPayConfigurator.exe.

   

2. В открывшемся окне укажите данные из шага 1:

   • IP — IP-адрес, на котором расположен кассовый сервер;
   • Порт — порт, указанный в свойствах кассового сервера в поле HTTP Data Port;
   • Пользователь — имя работника с ролью, у которой есть привилегия HTTP Access;
   • Пароль — пароль работника с привилегией HTTP Access.

3. Нажмите кнопку Тест соединения. Если пользователь и http-сервер на кассовом сервере настроены правильно, отобразится сообщение с версией кассового сервера.

   

4. Во вкладке Настройки в разделе Дополнительные:

   • в поле Интерфейс Farcards выберите Интерфейс Яндекс Пэй.
   • в поле Валюта Яндекс Пэй выберите валюту, созданную на шаге 4.

   В разделе Настройки платежной системы в поле User Token укажите токен, который вы выпустили в личном кабинете Яндекс Пэй.

   

5. Нажмите кнопку Сохранить настройки.

6. Во вкладке Статические qr-коды нажмите кнопку Загрузить Qr-коды из Яндекс.

   

   Если указан правильный User Token и на стороне сервера Яндекс Пэй есть информация о QR-табличках, они отобразятся в таблице.

   

7. Для каждой QR-таблички настройте, на какой кассе она будет использоваться:

   1. Выделите строку в таблице и нажмите на кнопку с тремя точками над таблицей.

      

   2. В открывшейся форме выберите нужную кассу и действие с QR-табличкой.

8. После окончательной настройки статических QR-кодов еще раз нажмите кнопку Сохранить настройки и закройте конфигуратор.

9. Запустите FarCards. Интеграция готова к использованию.