external:proprepayer:01_install_and_settings:03_admin

Это старая версия документа!


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

Админка: http://<IP сервера>:11260/admin, пароль по умолчанию 051791 (см. Установка службы).
В шапке видны версия, порт и имя службы. Над разделами показываются важные предупреждения: нет связи с платёжным шлюзом, низкий баланс SMS, нет лицензии.

Разделы настраиваются сверху вниз. В каждом разделе после изменений нажмите «Сохранить».

  • IP кассового сервера и порт XML-интерфейса.
  • Логин и пароль пользователя r_keeper с правом на XML-интерфейс.
  • «Проверить связь» — запрашивает у кассового сервера сведения о системе.

Связь с r_keeper

1 — адрес кассового сервера и порт XML-интерфейса; 2 — пользователь r_keeper; 3 — «Проверить связь».

Справочники загружаются с кассового сервера, поэтому сначала настройте связь с r_keeper. Во всех списках можно искать по части названия.

  • Валюта предоплаты — валюта, которой вносится аванс. Валюты типа «Зачёт аванса» не показываются.
  • Причина внесения — показываются только причины с галочкой «Предоплата».
  • Станция печати чека — касса, на которой печатается фискальный чек «Аванс». Одна для всех оплат. У станции должен быть назначен принтер «Для чеков».
  • Сотрудник-автор — от его имени вносится предоплата.
  • «Сообщать официанту об успешном зачислении» — по умолчанию включено. Официант заказа получает сообщение «Стол 15, заказ 15: получена предоплата 5 000 руб.». Сообщения о проблемах (заказ открыт на кассе, предоплата не внесена) приходят всегда.

Зачисление предоплаты

1 — валюта предоплаты; 2 — причина внесения; 3 — станция печати чека; 4 — сотрудник-автор; 5 — сообщение официанту об успешном зачислении.

Выберите шлюз — ЮKassa или Best2Pay / Paygine, введите ключи и нажмите «Проверить ключи». Подробно о регистрации в шлюзах и о каждом поле — в статье Платёжные шлюзы.

Платёжный шлюз: ЮKassa

1 — выбор шлюза; 2 — shopId и секретный ключ; 3 — страница после оплаты; 4 — «Проверить ключи».

Важно: меняйте шлюз, когда нет неоплаченных ссылок. После смены ProPrepayer проверяет оплаты только у нового шлюза.

  • Отправлять ссылку по SMS — если выключить, на форме не будет кнопки «Отправить по SMS», ссылку передают только через QR-код.
  • SMS-шлюз — i-Digital.
  • Ключ API — ключ типа «Сообщения» из кабинета i-Digital.
  • Имя отправителя — по умолчанию sms_promo (общее имя тарифа «Промо» без абонплаты).
  • Критический баланс — если баланс ниже, на форме и в админке появляется красное предупреждение «пополните счёт». По умолчанию 1000 руб.
  • Текущий баланс обновляется после каждой отправки и кнопкой «Обновить баланс».
  • Тестовое SMS — отправляет на указанный номер сообщение «ProPrepayer: тестовое сообщение». SMS платная.

Подробно — SMS: i-Digital.

SMS

1 — включение SMS; 2 — ключ API; 3 — имя отправителя; 4 — критический баланс; 5 — тестовое SMS; 6 — «Обновить баланс».

  • Название ресторана — для справки, в сообщение не подставляется.
  • Шаблон — текст SMS и QR-кода. По умолчанию:
Ресторан НАЗВАНИЕ. Платёжная ссылка для внесения аванса: {LINK}

Переменные: {SUM} — сумма аванса, {LINK} — ссылка (обязательна). Название ресторана пишите прямо в тексте и в начале: на тарифе «Промо» гость видит отправителем имя общего маршрута, а не ресторан. Под полем показывается длина и число частей SMS — ссылка в SMS сокращается до вида 9ap.ru/…, поэтому шаблон по умолчанию занимает одну часть.

  • Сумма по умолчанию — что подставляется в поле суммы на форме:
    • пусто;
    • фиксированная сумма, руб.;
    • остаток по заказу (сумма заказа минус уже внесённые предоплаты);
    • процент от суммы заказа — округляется вниз до 100 руб. (3 166,50 → 3 100); если получается 0 — до рубля.

Шаблон и сумма

1 — название ресторана; 2 — шаблон сообщения; 3 — сумма по умолчанию.

Изменения применяются сразу, перезапуск службы не нужен. Значения по умолчанию подходят большинству ресторанов.

Параметр По умолчанию Допустимо Что означает
Опрос об оплатах 12 с 5–60 с Как часто ProPrepayer спрашивает платёжный шлюз о новых оплатах. Запросы идут, только пока есть неоплаченные ссылки
Повтор зачисления 30 с 10–300 с Как часто повторять внесение, если заказ открыт на кассе или не печатается чек
Сообщение и окно на кассе 60 с 0–600 с Через сколько после неудачной попытки сообщить официанту и открыть окно «выйдите из заказа» на кассе, где открыт заказ
Перенос в «Требует внимания» 600 с 60–3600 с Сколько пытаться внести, прежде чем оплата попадёт в «Требует внимания». Заказ, открытый на кассе, ждёт сколько угодно
Уровень логирования Обычный Обычный / Подробный «Подробный» дополнительно пишет полные запросы и ответы r_keeper, ЮKassa и i-Digital. Включайте на время разбора проблемы
Размер файла лога 5 МБ
Хранить файлов 10 Файлы logs\proprepayer.log.N
Статистика Включено Включено / выключено «Отправлять анонимную статистику в Карбис» — см. ниже

Системные настройки

1 — уровень логирования: «Подробный» включайте только на время разбора проблемы.

Анонимная статистика (с версии 1.3.0). Раз в сутки ночью ProPrepayer отправляет в Карбис статистику за прошедшие дни: сколько создано ссылок, отправлено SMS, получено оплат и внесено предоплат, их сумму, число ошибок, а также какой шлюз выбран и включены ли SMS. Телефоны и e-mail гостей, заказы, адреса, ключи и пароли не отправляются. Статистика помогает нам развивать программу. Отправка идёт только при действующей лицензии. Чтобы отключить, снимите галочку «Отправлять анонимную статистику в Карбис» и нажмите «Сохранить»: статистика перестанет собираться, а уже собранная будет удалена. Под галочкой видно время последней отправки или ошибка.

Эти разделы нужны в работе, а не при настройке — см. Журнал и «Требует внимания».

Объект и срок лицензии lic.carbis.ru, связь с сервером лицензирования, кнопка «Проверить лицензию». Подробно — Лицензирование.

  1. Откройте заказ на кассе, нажмите клавишу «Предоплата по ссылке» — откроется форма с суммой заказа.
  2. Создайте ссылку на небольшую сумму (например, 10 руб.) с вашим телефоном и e-mail, отправьте SMS.
  3. Оплатите по ссылке и выйдите из заказа.
  4. В течение минуты предоплата появится в заказе, напечатается чек «Аванс», официант получит сообщение.
  5. Верните тестовую оплату в кабинете шлюза и удалите предоплату штатно в r_keeper.
  • external/proprepayer/01_install_and_settings/03_admin.1794496178.txt.gz
  • Последнее изменение: 2026/11/12 15:09
  • — Алексей Коробов