====== Настройка в админке ProPrepayer ====== Админка: http://:11260/admin, пароль по умолчанию 051791 (см. [[external:proprepayer:01_install_and_settings:02_install|Установка службы]]). В шапке видны версия, порт и имя службы. Над разделами показываются важные предупреждения: нет связи с платёжным шлюзом, низкий баланс SMS, нет лицензии. Разделы настраиваются сверху вниз. В каждом разделе после изменений нажмите **«Сохранить»**. ===== Связь с r_keeper ===== * **IP кассового сервера** и **порт XML-интерфейса**. * **Логин** и **пароль** пользователя r_keeper с правом на XML-интерфейс. * **«Проверить связь»** — запрашивает у кассового сервера сведения о системе. {{:external:proprepayer:proprepayer_admin_rk.png?direct&900|Связь с r_keeper}} //1 — адрес кассового сервера и порт XML-интерфейса; 2 — пользователь r_keeper; 3 — «Проверить связь».// ===== Зачисление предоплаты ===== Справочники загружаются с кассового сервера, поэтому сначала настройте связь с r_keeper. Во всех списках можно искать по части названия. * **Валюта предоплаты** — валюта, которой вносится аванс. Валюты типа «Зачёт аванса» не показываются. * **Причина внесения** — показываются только причины с галочкой «Предоплата». * **Станция печати чека** — касса, на которой печатается фискальный чек «Аванс». Одна для всех оплат. У станции должен быть назначен принтер «Для чеков». * **Сотрудник-автор** — от его имени вносится предоплата. * **«Сообщать официанту об успешном зачислении»** — по умолчанию включено. Официант заказа получает сообщение «Стол 15, заказ 15: получена предоплата 5 000 руб.». Сообщения о проблемах (заказ открыт на кассе, предоплата не внесена) приходят всегда. {{:external:proprepayer:proprepayer_admin_credit.png?direct&900|Зачисление предоплаты}} //1 — валюта предоплаты; 2 — причина внесения; 3 — станция печати чека; 4 — сотрудник-автор; 5 — сообщение официанту об успешном зачислении.// ===== Платёжный шлюз ===== Выберите шлюз — ЮKassa или Best2Pay / Paygine, введите ключи и нажмите **«Проверить ключи»**. Подробно о регистрации в шлюзах и о каждом поле — в статье [[external:proprepayer:01_install_and_settings:04_payment|Платёжные шлюзы]]. {{:external:proprepayer:proprepayer_admin_gw_yk.png?direct&900|Платёжный шлюз: ЮKassa}} //1 — выбор шлюза; 2 — shopId и секретный ключ; 3 — страница после оплаты; 4 — «Проверить ключи».// **Важно:** меняйте шлюз, когда нет неоплаченных ссылок. После смены ProPrepayer проверяет оплаты только у нового шлюза. ===== SMS ===== * **Отправлять ссылку по SMS** — если выключить, на форме не будет кнопки «Отправить по SMS», ссылку передают только через QR-код. * **SMS-шлюз** — i-Digital. * **Ключ API** — ключ типа «Сообщения» из кабинета i-Digital. * **Имя отправителя** — по умолчанию sms_promo (общее имя тарифа «Промо» без абонплаты). * **Критический баланс** — если баланс ниже, на форме и в админке появляется красное предупреждение «пополните счёт». По умолчанию 1000 руб. * **Текущий баланс** обновляется после каждой отправки и кнопкой **«Обновить баланс»**. * **Тестовое SMS** — отправляет на указанный номер сообщение «ProPrepayer: тестовое сообщение». SMS платная. Подробно — [[external:proprepayer:01_install_and_settings:05_sms|SMS: i-Digital]]. {{:external:proprepayer:proprepayer_admin_sms.png?direct&900|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 — до рубля. {{:external:proprepayer:proprepayer_admin_tpl.png?direct&900|Шаблон и сумма}} //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 | | Статистика | Включено | Включено / выключено | «Отправлять анонимную статистику в Карбис» — см. ниже | {{:external:proprepayer:proprepayer_admin_sys.png?direct&900|Системные настройки}} //1 — уровень логирования: «Подробный» включайте только на время разбора проблемы; 2 — отправка анонимной статистики; 3 — время последней отправки или ошибка.// **Анонимная статистика** (с версии 1.3.0). Раз в сутки ночью ProPrepayer отправляет в Карбис статистику за прошедшие дни: сколько создано ссылок, отправлено SMS, получено оплат и внесено предоплат, их сумму, число ошибок, а также какой шлюз выбран и включены ли SMS. Телефоны и e-mail гостей, заказы, адреса, ключи и пароли не отправляются. Статистика помогает нам развивать программу. Отправка идёт только при действующей лицензии. Чтобы отключить, снимите галочку «Отправлять анонимную статистику в Карбис» и нажмите «Сохранить»: статистика перестанет собираться, а уже собранная будет удалена. Под галочкой видно время последней отправки или ошибка. ===== Журнал и «Требует внимания» ===== Эти разделы нужны в работе, а не при настройке — см. [[external:proprepayer:03_journal|Журнал и «Требует внимания»]]. ===== Лицензия ===== Объект и срок лицензии lic.carbis.ru, связь с сервером лицензирования, кнопка **«Проверить лицензию»**. Подробно — [[external:proprepayer:01_install_and_settings:06_license|Лицензирование]]. ===== Проверка после настройки ===== - Откройте заказ на кассе, нажмите клавишу «Предоплата по ссылке» — откроется форма с суммой заказа. - Создайте ссылку на небольшую сумму (например, 10 руб.) с вашим телефоном и e-mail, отправьте SMS. - Оплатите по ссылке и **выйдите из заказа**. - В течение минуты предоплата появится в заказе, напечатается чек «Аванс», официант получит сообщение. - Верните тестовую оплату в кабинете шлюза и удалите предоплату штатно в r_keeper.