Это старая версия документа!
Настройка в админке ProPrepayer
Админка: http://<IP сервера>:11260/admin, пароль по умолчанию 051791 (см. Установка службы).
В шапке видны версия, порт и имя службы. Над разделами показываются важные предупреждения: нет связи с платёжным шлюзом, низкий баланс SMS, нет лицензии.
Разделы настраиваются сверху вниз. В каждом разделе после изменений нажмите «Сохранить».
Связь с r_keeper
- IP кассового сервера и порт XML-интерфейса.
- Логин и пароль пользователя r_keeper с правом на XML-интерфейс.
- «Проверить связь» — запрашивает у кассового сервера сведения о системе.
1 — адрес кассового сервера и порт XML-интерфейса; 2 — пользователь r_keeper; 3 — «Проверить связь».
Зачисление предоплаты
Справочники загружаются с кассового сервера, поэтому сначала настройте связь с r_keeper. Во всех списках можно искать по части названия.
- Валюта предоплаты — валюта, которой вносится аванс. Валюты типа «Зачёт аванса» не показываются.
- Причина внесения — показываются только причины с галочкой «Предоплата».
- Станция печати чека — касса, на которой печатается фискальный чек «Аванс». Одна для всех оплат. У станции должен быть назначен принтер «Для чеков».
- Сотрудник-автор — от его имени вносится предоплата.
- «Сообщать официанту об успешном зачислении» — по умолчанию включено. Официант заказа получает сообщение «Стол 15, заказ 15: получена предоплата 5 000 руб.». Сообщения о проблемах (заказ открыт на кассе, предоплата не внесена) приходят всегда.
1 — валюта предоплаты; 2 — причина внесения; 3 — станция печати чека; 4 — сотрудник-автор; 5 — сообщение официанту об успешном зачислении.
Платёжный шлюз
Выберите шлюз — ЮKassa или Best2Pay / Paygine, введите ключи и нажмите «Проверить ключи». Подробно о регистрации в шлюзах и о каждом поле — в статье Платёжные шлюзы.
1 — выбор шлюза; 2 — shopId и секретный ключ; 3 — страница после оплаты; 4 — «Проверить ключи».
Важно: меняйте шлюз, когда нет неоплаченных ссылок. После смены ProPrepayer проверяет оплаты только у нового шлюза.
SMS
- Отправлять ссылку по SMS — если выключить, на форме не будет кнопки «Отправить по SMS», ссылку передают только через QR-код.
- SMS-шлюз — i-Digital.
- Ключ API — ключ типа «Сообщения» из кабинета i-Digital.
- Имя отправителя — по умолчанию sms_promo (общее имя тарифа «Промо» без абонплаты).
- Критический баланс — если баланс ниже, на форме и в админке появляется красное предупреждение «пополните счёт». По умолчанию 1000 руб.
- Текущий баланс обновляется после каждой отправки и кнопкой «Обновить баланс».
- Тестовое SMS — отправляет на указанный номер сообщение «ProPrepayer: тестовое сообщение». SMS платная.
Подробно — SMS: i-Digital.
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 — уровень логирования: «Подробный» включайте только на время разбора проблемы.
Журнал и «Требует внимания»
Эти разделы нужны в работе, а не при настройке — см. Журнал и «Требует внимания».
Лицензия
Объект и срок лицензии lic.carbis.ru, связь с сервером лицензирования, кнопка «Проверить лицензию». Подробно — Лицензирование.
Проверка после настройки
- Откройте заказ на кассе, нажмите клавишу «Предоплата по ссылке» — откроется форма с суммой заказа.
- Создайте ссылку на небольшую сумму (например, 10 руб.) с вашим телефоном и e-mail, отправьте SMS.
- Оплатите по ссылке и выйдите из заказа.
- В течение минуты предоплата появится в заказе, напечатается чек «Аванс», официант получит сообщение.
- Верните тестовую оплату в кабинете шлюза и удалите предоплату штатно в r_keeper.





