---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://pay.yandex.ru/docs/ru/qr-code/rkeeper.md
  - href: ru/qr-code/rkeeper.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: "Подключение QR‑кода\_от\_Яндекс\_Пэй к r_keeper — настройка оплаты по СБП | Документация"
description: "Пошаговая инструкция по подключению QR‑кода\_от\_Яндекс\_Пэй к кассовому ПО r_keeper. Настройка приема платежей по СБП для ресторанов и кафе."
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt


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

{% note warning %}

QR‑код от Яндекс Пэй доступен для r_keeper версии 7.25.12 от 15.12.2025 и выше.

{% endnote %}

1. <!-- source: ru/_includes/cash-registers.md -->
   Если вы еще не подключили QR‑код от Яндекс Пэй и не заказали табличку с QR-кодом, выполните шаги 1–3 [инструкции](https://pay.yandex.ru/docs/ru/qr-code/index.md#qr-table).
   <!-- endsource: ru/_includes/cash-registers.md -->

1. После того как вы выпустили [токен](https://pay.yandex.ru/docs/ru/qr-code/index.md#token), у вас есть два варианта настройки интеграции:

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

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

   - Вариант 2. Настроить самостоятельно.
   
     Если у вас есть технические специалисты, вы можете выполнить настройку ПО самостоятельно по [инструкции](#integration-setup).

1. <!-- source: ru/qr-code/_includes/testing.md -->
   После того как ПО будет настроено, [протестируйте](https://pay.yandex.ru/docs/ru/qr-code/index.md#testing) оплату заказа и возврат средств, чтобы проверить работу сервиса.
   <!-- endsource: ru/qr-code/_includes/testing.md -->

## Самостоятельная настройка ПО {#integration-setup}

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

- [Настройки в менеджерской станции](#manager-station)
- [Настройки в конфигураторе QR-кодов от Яндекс Пэй](#configurator)

{% note tip %}

Чтобы открыть изображения на весь экран, перейдите в режим чтения с помощью кнопки ![](../console/_assets//btn-read-mode.svg) в правом верхнем углу страницы.

{% endnote %}

## Настройки в менеджерской станции {#manager-station}

### Шаг 1. Настройка HTTPS сервера на кассовом сервере {#step-1__https-server}

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

   ![](./_assets/rkeeper-1.png =440x){.c-screenshot}

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

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

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

   ![](./_assets/rkeeper-2.png){.c-screenshot}

1. Дайте доступ на привилегию работнику:
   1. В справочнике **Персонал** → **Работники** выберите роль работников или создайте новую. 
   
   1. Во вкладке **Свойства** в разделе **Менеджерские ограничения** добавьте привилегию **HTTP Access**.

      ![](./_assets/rkeeper-3.png){.c-screenshot}

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

### Шаг 2. Добавление PDS интерфейса {#step-2__pds-interface}

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

1. Во вкладке **Устройства** добавьте новый PDS интерфейс:
   1. Откройте контекстное меню и выберите **Список драйверов**.

      ![](./_assets/rkeeper-4.png){.c-screenshot}

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

      ![](./_assets/rkeeper-5.png){.c-screenshot}

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

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

   ![](./_assets/rkeeper-6.png =500x){.c-screenshot}

   #|
   || **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. Добавление нового интерфейса по взаимодействию с Яндекс Пэй {#step-3__interface}

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

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

   ![](./_assets/rkeeper-7.png =700x){.c-screenshot}

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

### Шаг 4. Добавление нового типа валют и валюты {#step-4__currency}

Подробнее о валютах см. на сайте **r_keeper** в разделе [Настройка Валют](https://docs.rkeeper.ru/rk7/latest/ru/nastrojka-valyut-4038192.html).

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

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

   ![](./_assets/rkeeper-8.png =500x){.c-screenshot}

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

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

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

   ![](./_assets/rkeeper-9.png){.c-screenshot}

   #|
   || **Название** | `Яндекс Пэй` ||
   || **Статус** | `Активный` ||
   || **Не в сдаче** | Включите опцию ||
   || **Без сдачи** | Включите опцию ||
   || **Тип фискальности** | `Фискальный чек` ||
   || **Автозаполнение** | `Вся сумма` ||
   || **Способ ввода доп.инфо** | `guid валюты` ||
   || **Интерфейс** | Выберите интерфейс Яндекс Пэй, который вы добавили на [шаге 3](#step-3__interface) ||
   |#

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

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

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

   ![](./_assets/rkeeper-10.png){.c-screenshot}

### Шаг 5. Настройка MCR-алгоритма {#step-5__mcr-algorithm}

Подробнее о MCR-алгоритмах см. на сайте **r_keeper** в разделе [Справочник MCR алгоритмы](https://docs.rkeeper.ru/rk7/latest/ru/spravochnik-mcr-algoritmy-4038483.html).

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

   ![](./_assets/rkeeper-11.png =800x){.c-screenshot}

   #|
   || **Собственное имя** | `Mcr Яндекс Пэй` ||
   || **Статус** | `Активный` ||
   || **Тип алгоритма** | `Скрипт вер. 7.0` ||
   || **Типы устройств** | Включите все опции ||
   || **Область** | `Интерфейс` ||
   || **Объект** | `Интерфейс Яндекс Пэй`
   
   {% note info %}

   Это значение станет доступно после выбора значения `Интерфейс` в поле **Область**.

   {% endnote %}

   ||
   || **Скрипт** | 
   Нажмите на три точки и вставьте скрипт:

   ```
   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](#step-4__currency).

     ![](./_assets/rkeeper-12.png =500x){.c-screenshot}

   ||
   |#

### Шаг 6. Изменение общих настроек системы {#step-6__system-settings}

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

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

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

{% note warning %}

Перед настройкой конфигуратора выполните все [настройки в менеджерской станции](#manager-station) и перезапустите кассовый сервер.

Скачайте DLL. Он работает с r_keeper версии 7.25.12 от 15.12.2025 и выше.

<a class="custom-g-button custom-g-button_view_normal custom-g-button_size_l" href="https://doc-static.yandex.net/src/support/yandex_pay/qr-code/rkeeper-dll.zip" target="_blank" download>
  <span class="g-button__text">
    Скачать
  </span>
</a>

{% endnote %}

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

   ![](./_assets/rkeeper-13.png =600x){.c-screenshot}

1. В открывшемся окне укажите данные из [шага 1](#step-1__https-server):

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

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

   ![](./_assets/rkeeper-14.png =600x){.c-screenshot}

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

   - в поле **Интерфейс Farcards** выберите **Интерфейс Яндекс Пэй**.
   - в поле **Валюта Яндекс Пэй** выберите валюту, созданную на [шаге 4](#step-4__currency).

   В разделе **Настройки платежной системы** в поле **User Token** укажите [токен](https://pay.yandex.ru/docs/ru/qr-code/index.md#token), который вы выпустили в личном кабинете Яндекс Пэй.

   ![](./_assets/rkeeper-15.png =600x){.c-screenshot}

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

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

   ![](./_assets/rkeeper-16.png =600x){.c-screenshot}

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

   ![](./_assets/rkeeper-17.png =600x){.c-screenshot}

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

      ![](./_assets/rkeeper-18.png =600x){.c-screenshot}

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

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

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