POS-терминал и касса
Конфигурация типа «POS-терминал (прием платежей)» превращает терминал JustPay в платёжный терминал для кассовой программы: касса (1С, БИФИТ Касса, учётная система, паркомат) передаёт сумму, терминал проводит оплату картой или по СБП и возвращает кассе результат. Здесь — как это устроено, каждое поле настроек, кто печатает чек, пошаговая настройка и частые проблемы. В конце — чем от этого типа отличаются «Прием платежей» и «Курьер».
Что такое POS-терминал в JustPay
У типа «POS-терминал (прием платежей)» нет каталога, планограммы и экранов выбора товара. Терминал ждёт команду от внешней системы — кассовой программы — и выполняет её через банковское ПО, установленное на терминале. Сумму и состав чека задаёт касса, а не терминал.
- Касса: сумма и состав чека
- Терминал JustPay: способ оплаты
- Банковское ПО: карта или СБП
- Сервер JustPay: регистрация и чек
- Ответ кассе
Место типа в общей схеме — как у любого сценария: Место обслуживания → Точка (способы оплаты, банковское ПО, касса для чеков) → Конфигурация (этот тип) → терминал.
| Задача | Какой тип выбрать |
|---|---|
| Терминал стоит рядом с кассой (или касса установлена на самом терминале), сумму передаёт кассовая программа | POS-терминал (прием платежей) — эта статья |
| Кассир сам набирает товары или свободную сумму на экране терминала, нужно меню кассира (смены, история, возврат) | POS-точка — каталог, корзина, свободная цена, меню кассира |
| Покупатель сам вводит произвольную сумму (пожертвование, оплата услуги без кассы) | Пожертвования (кнопка «Ваша сумма») |
| Оплата начислений по лицевому счёту, договору, УИН | «Прием платежей» — ниже и Оплата услуг и заказов |
Сумму на самом терминале в этом типе не вводят. Экран терминала — это экран ожидания с логотипом и текстами; кнопок ввода суммы и меню кассира на нём нет. Если нужен «пин-пад, на котором продавец набирает сумму», используйте POS-точку со свободной ценой.
Два сценария работы с кассой
Терминал рядом с кассой (касса на компьютере)
Кассовая программа работает на компьютере или моноблоке, терминал JustPay стоит рядом и подключён к той же локальной сети (Wi-Fi или Ethernet). Касса обращается к терминалу по сети: IP-адрес терминала + порт из конфигурации. На терминале постоянно открыт экран ожидания JustPay; во время оплаты на нём появляется экран оплаты.
Рекомендуемый Режим запуска — «Приложение». Терминалу нужен постоянный (статический) IP-адрес в сети — иначе после перезагрузки роутера касса его «потеряет». См. Статический IP и DHCP.
Касса установлена на самом терминале
Кассовое приложение (например, БИФИТ Касса или 1С Мобильная касса) установлено прямо на POS-терминал. Тогда JustPay работает в фоне, а касса обращается к нему по адресу 127.0.0.1 (тот же терминал) и порту из конфигурации. Окно JustPay появляется поверх кассы только на время оплаты и само закрывается после неё.
Рекомендуемый Режим запуска — «Служба».
В обоих сценариях на терминале должно быть установлено и активировано банковское ПО банка-эквайера, а в карточке точки выбран соответствующий «Вид банковского ПО» — см. Способы оплаты. Эквайринг подключает JustPay: по вашей заявке мы сами подаём заявку в банк, устанавливаем и активируем банковское ПО. JustPay не заменяет банковское ПО, а вызывает его.
Как проходит оплата
- Касса формирует запрос. Кассир пробивает товары в кассовой программе и выбирает оплату картой. Касса отправляет на терминал команду «оплата» с суммой; по протоколу JUSTPAY — ещё и состав чека, имя кассира и, при необходимости, способ оплаты.
- Терминал выбирает способ оплаты. Если касса указала способ (карта или СБП), терминал сразу переходит к нему. Если не указала и на точке включено несколько способов — покупатель видит экран «Выберите способ оплаты».
- Оплата. Картой — открывается банковское приложение, покупатель прикладывает карту. По СБП — на экране терминала появляется QR-код, покупатель оплачивает его в приложении своего банка.
- Регистрация в JustPay. Если в конфигурации включено «Отправлять операции на сервер», терминал регистрирует платёж в личном кабинете; сервер формирует чек, если это предусмотрено настройками фискализации.
- Ответ кассе. Терминал возвращает кассе результат: успешно или отказ с кодом и текстом ответа банка, номер операции (RRN), код авторизации, маскированный номер карты и текст банковского слипа. При регистрации в JustPay — ещё ссылку на чек и, по запросу кассы, QR-код чека и фискальные данные.
- Касса завершает продажу. Касса печатает слип и (если чек печатает она) фискальный чек, закрывает документ продажи.
Так же, по команде кассы, выполняются отмена/возврат (касса передаёт сумму и RRN исходной операции) и сверка итогов.
Экраны оплаты, QR-кода СБП, проведения платежа, успеха и ошибки — общие для всех сценариев, их вид настраивается на вкладке «Интерфейс» и описан в статье Приложение на терминале. Время показа экрана результата задаёт поле «Таймаут показа чека (сек)».
Как это выглядит на стороне кассы
Если касса подключена через платёжный модуль JustPay для кассовой программы (поставляется по согласованию с поддержкой), порядок такой:
- Кассовая программа вызывает платёжный модуль; на экране кассы появляется окно «ОПЛАТА на сумму …» с выбором способа: Банковской картой (клавиша 1), QR-код СБП (клавиша 2). Отменить — Esc закрывает окно без оплаты.
- После выбора команда уходит на терминал, в окне модуля — «Ожидайте — операция выполняется. Идёт соединение с банком».
- При успехе — «ОПЛАТА УСПЕШНО»; модуль передаёт кассе код ответа и образ чека (слипа), касса печатает его на своём принтере.
- При отказе — «ОШИБКА» и код ответа банка с расшифровкой (например, «нет связи с банком»).
Отмена операции по карте выглядит так же: окно «Отмена на сумму …», по результату — «ОТМЕНА УСПЕШНО» или «ОШИБКА» с кодом.
Протоколы: чем касса «разговаривает» с терминалом
Протокол выбирается в поле Протокол на вкладке «Настройки» конфигурации. Для работы с кассой используются два.
| Возможность | JustPay (протокол JUSTPAY) | TTK2 (эмуляция протокола Сбербанка) |
|---|---|---|
| Для каких касс | Касса или учётная система, в которую встроена интеграция с JustPay (делает её разработчик кассы по описанию протокола) | Любая касса, умеющая работать с пин-падом Сбербанка по сети (TCP/IP): в ней выбирают эквайринг «Сбербанк», а терминал JustPay «притворяется» пин-падом |
| Порт по умолчанию | 14200 | 8888 |
| Оплата, отмена, возврат, сверка итогов | Да | Да |
| Передача состава чека (товары, количество, ставки НДС, кассир, e-mail покупателя) | Да | Нет — передаётся только сумма |
| Ответ с данными чека JustPay (ссылка, QR-код чека, фискальные данные) | Да | Нет |
| Когда выбирать | Нужен полный состав чека в ЛК и чек от JustPay | Кассу дорабатывать нельзя или не нужно; чек печатает сама касса |
При выборе протокола в ЛК поле Порт для подключения заполняется автоматически: «JustPay» — 14200, «TTK2» — 8888. Порт можно изменить, но тогда тот же порт нужно указать в кассовой программе.
Техническое описание протокола JUSTPAY (формат запросов и ответов) для разработчика кассовой программы предоставляет поддержка JustPay. Для протокола TTK2 используется описание протокола Сбербанка, которое есть у разработчика кассы.
Что важно знать разработчику кассовой интеграции (протокол JUSTPAY)
- Запрос отправляется на терминал:
http://<IP-адрес терминала>:<порт>, тело — JSON. Если касса работает на том же терминале — адрес 127.0.0.1. - Типы операций: 0 — сверка итогов, 1 — оплата, 2 — отмена (возврат) по RRN, 3 — отмена с указанием позиций.
- Суммы должны сходиться. Сумма по позиции = цена × количество, итог платежа = сумма всех позиций. Если нет — терминал не проводит оплату и возвращает ошибку вида «Некорректная сумма по позициям, должно быть: …, имеется: …».
- Способ оплаты: 1 — банковская карта, 2 — СБП. Рекомендуем передавать его всегда: тогда терминал не показывает покупателю экран выбора.
- Ставки НДС передаются кодами справочника JustPay — те же, что в карточке номенклатуры.
- Если формирование чека в JustPay включено, передавайте имя кассира и состав чека; для отправки чека на почту — e-mail покупателя.
- Если регистрация в JustPay выключена, часть полей ответа не заполняется: результат оплаты и отмены определяют по блоку с данными банковской операции, результат сверки — по данным сверки.
Вкладка «Общие данные»
Заполняется так же, как у любой конфигурации: Тип конфигурации — «POS-терминал (прием платежей)», Название, Описание, Наименование клиента; Дата версии, Версия и Статус — служебные. Подробно — Конфигурации → Общие данные. У этого типа три вкладки: «Общие данные», «Настройки», «Интерфейс».
Тип у существующей конфигурации технически изменить можно, но делать этого не следует: смена типа может нарушить логику работы терминала. Нужен другой сценарий — создайте новую конфигурацию нужного типа.
Вкладка «Настройки»: каждое поле
Ниже — все поля вкладки в том порядке, в каком они идут в ЛК. Поля, общие для всех типов, описаны кратко — подробнее в статье Конфигурации; поля, важные именно для работы с кассой, — подробно.
| Поле | Что задаёт | На что влияет |
|---|---|---|
| Сервер, Порт | Адрес сервера JustPay; заполняются автоматически (адрес личного кабинета и 443). | Служебные, не меняйте. Адрес сервера терминал берёт из своей привязки к точке. |
| Режим запуска | «Приложение» (по умолчанию) или «Служба». | Будет ли у JustPay собственный экран на терминале. Подробно — ниже. |
| Протокол | Как касса обменивается с терминалом: «JustPay» (по умолчанию), «TTK2», а также «Jetinno», «Wizarpos», «MSB», «Inpas», «SoftPos». | Какие команды понимает терминал и в каком формате отвечает. Для кассы — «JustPay» или «TTK2». Все значения — ниже. |
| Порт для подключения | Сетевой порт, на котором терминал ждёт команды кассы. Число. При выборе протокола заполняется само: 14200 для «JustPay», 8888 для «TTK2». | Этот же порт указывают в настройках кассовой программы. Если порты не совпадают — касса не «видит» терминал. Порт должен быть открыт в локальной сети от кассы к терминалу. |
| Тайм-аут | Служебный параметр ожидания подключения кассы. По умолчанию 60000. | На оплату и на экраны не влияет: если касса долго не подключается, терминал просто продолжает ждать подключения. Оставьте значение по умолчанию. |
| Отправлять операции на сервер | Регистрировать ли операции, проведённые по командам кассы, в JustPay. По умолчанию включено. | Включено — платежи, возвраты и сверки видны в личном кабинете, сервер формирует чек по настройкам фискализации, касса получает ссылку на чек. Выключено — терминал только проводит банковскую операцию и отвечает кассе; в ЛК операции не появятся, чек JustPay не сформирует. Подробно — ниже. |
| Тип цены | «Брать из номенклатуры» или «Брать из настроек аппарата». | Используется только в вендинге. Для POS-терминала не влияет: сумму всегда задаёт касса. |
| Наименование номенклатуры (по умолчанию) | Позиция из вашей номенклатуры; в списке показываются название и номер. | Какое название и какая ставка НДС попадут в позицию чека, если касса передала только сумму без состава. Работает только вместе со следующим флажком. Подробно — ниже. |
| Использовать значение по умолчанию | Флажок. По умолчанию снят. | Включает подстановку позиции из поля слева. Без флажка выбранная номенклатура не используется. |
| Тип первого экрана | Вариант стартового экрана. | Для POS-терминала не влияет: стартовый экран определяется типом конфигурации. |
| Тип экрана оплаты | Вариант экрана выбора способа оплаты. | В текущей версии приложения терминала не используется. |
| Таймаут главного экрана (сек) | — | В текущей версии приложения терминала не используется. |
| Таймаут выбора товара (сек) | — | Используется только в вендинге. |
| Таймаут показа чека (сек) | Сколько секунд держится экран результата (успех или ошибка). | Задайте 10–20 секунд, если покупатель должен успеть отсканировать QR-код чека с экрана; иначе экран сменится почти сразу. |
| Таймаут ожидания фискализации (сек) | Сколько сервер ждёт регистрации чека. По умолчанию 5. | Используется сервером только вместе с флажком «Обязательность фискализации». |
| Таймаут оплаты по карте (сек) | По умолчанию 150. | Действует только с банковским ПО «SkyPos»; для остальных время ожидания карты задаёт само банковское ПО. |
| Таймаут оплаты по СБП (сек) | Сколько секунд QR-код СБП ждёт оплаты. По умолчанию 150. | По истечении времени терминал перестаёт ждать оплату. 0 или пусто — 65 секунд. |
| Тип экрана при сканировании Цифрового ID MAX | Как проверять покупателя через MAX. | Действует, только если идентификация MAX настроена в точке — Идентификация MAX. |
| Обязательность фискализации | Флажок. По умолчанию снят. | Сервер ждёт регистрации чека; если чек не пробит — платёж получает статус ошибки ККТ. Для POS-терминала с кассой включайте только по согласованию с поддержкой. Подробнее — Конфигурации. |
| Фискализация наличных операций | Флажок. По умолчанию включён. | Чек JustPay на операции, учтённые как наличные. В связке с кассой наличные принимает сама касса, поэтому флажок обычно ни на что не влияет. |
| Фискализация безналичных операций | Флажок. По умолчанию включён. | Сервер JustPay формирует чек на оплаты картой и по СБП (при включённой отправке операций на сервер и подключённой к точке ККТ). Если чек печатает ваша касса — снимите флажок, иначе на одну покупку будет два чека. См. Кто печатает чек. |
Внизу формы: Назад — закрыть без сохранения, Сохранить — сохранить и выйти, Применить — сохранить и остаться в форме.
Режим запуска: «Приложение» или «Служба»
| Значение | Что на терминале | Когда выбирать |
|---|---|---|
| Приложение по умолчанию | Приложение JustPay всё время открыто: экран ожидания с логотипом, «Текст 1» и «Текст 2» с вкладки «Интерфейс». При команде кассы на этом же экране открывается оплата, после неё терминал возвращается к экрану ожидания. | Касса работает на отдельном компьютере, терминал стоит рядом как пин-пад. |
| Служба | Своего экрана у JustPay нет, приложение работает в фоне. Окно оплаты открывается поверх кассовой программы только на время операции и закрывается само. | Кассовая программа установлена на самом терминале, кассир весь день работает в ней. |
Режим применяется при запуске приложения. После смены отправьте задание «Обновление конфигурации» или перезапустите приложение. В режиме «Служба» из заданий личного кабинета терминал выполняет «Сверку итогов» и «Обновление конфигурации»; остальные задания завершаются с сообщением «В данном режиме поддерживается только сверка».
Протокол — все значения списка
| Значение | Что это | Для POS-терминала с кассой |
|---|---|---|
| JustPay | Протокол JUSTPAY: JSON-запросы по сети, полный набор функций, включая состав чека и чек JustPay. | Да, основной вариант. Порт по умолчанию 14200. |
| TTK2 | Эмуляция протокола пин-пада Сбербанка (ТТК): терминал понимает команды так, как их понимал бы пин-пад Сбербанка, и вызывает банковское ПО, выбранное в точке. | Да, для касс, где настроен эквайринг «Сбербанк» по сети. Порт по умолчанию 8888. |
| Wizarpos | Платёжный интерфейс терминалов WizarPOS: другое приложение на этом же терминале вызывает JustPay как платёжный модуль, без сети. | Только для кассовых приложений, поддерживающих этот интерфейс, по согласованию с поддержкой. |
| Jetinno | Связь с кофейными автоматами Jetinno. | Нет — используется в POS-точке. |
| MSB, Inpas, SoftPos | Протоколы для отдельных проектов. При выборе MSB или Inpas появляются дополнительные поля подключения. | Серийная версия приложения терминала эти значения в POS-терминале не обрабатывает. Не выбирайте без указания поддержки. |
«Отправлять операции на сервер»: когда выключать
Оставляйте флажок включённым почти всегда. Тогда:
- каждая оплата, отмена и возврат по команде кассы появляется в разделе Платежи со статусом, составом (если касса его передала), данными карты и слипом; сверки — в разделе «Сверки итогов»;
- сервер формирует чек, если включены флажки фискализации и к точке подключена ККТ;
- касса получает в ответе ссылку на чек JustPay, а по запросу — QR-код чека для показа покупателю и фискальные данные.
Выключайте, только если учёт и чеки полностью ведёт ваша касса, а JustPay нужен исключительно как «провод» к банковскому ПО. Учтите: без регистрации в ЛК не будет ни отчётов JustPay по этим операциям, ни возврата из ЛК.
Номенклатура по умолчанию
Касса не всегда передаёт состав чека: по протоколу TTK2 приходит только сумма, а по протоколу JUSTPAY касса может прислать пустой список позиций. Тогда в платеже JustPay одна позиция на всю сумму:
- флажок «Использовать значение по умолчанию» снят — позиция называется «Продажа» (для возврата — «Возврат»), ставка НДС не задана;
- флажок установлен и выбрана номенклатура — позиция получает название и ставку НДС из выбранной номенклатуры (например, «Оплата услуг», НДС не облагается).
Если касса передала полный состав чека, используются её позиции; подстановка не делается.
Если чек формирует JustPay, а касса передаёт только сумму, обязательно выберите номенклатуру по умолчанию с правильной ставкой НДС и установите флажок. Номенклатуру создают в разделе Номенклатура; в поле показываются позиции вашей организации.
Вкладка «Интерфейс»
Три блока: Первый экран, Экран ошибки, Последний экран. Первый экран — это экран ожидания между оплатами (в режиме «Приложение»): цвет фона, цвет верхней полосы (Цвет тулбара), логотип и его размер, Текст 1 и Текст 2 (размер, цвет, текст). При флажке Изображение - во весь экран вместо текстов показывается только картинка. Экран ошибки и последний экран — общие экраны результата оплаты.
Пример текстов для экрана ожидания: «Оплата картой и по QR» / «Сумму назовёт кассир». В режиме «Служба» первый экран не показывается.
Все поля блоков, форматы цветов и картинок — Оформление экранов терминала.
Карточка точки: что настроить для POS-терминала
Конфигурация задаёт сценарий, а банк, способы оплаты и касса для чеков — в карточке точки.
| Где в карточке | Что выбрать | Почему |
|---|---|---|
| Конфигурация | Созданную конфигурацию типа «POS-терминал (прием платежей)». | Без неё терминал не узнает, что работает с кассой. |
| Способы оплаты → Оплата банковской картой, Вид банковского ПО | Включить, выбрать ПО, установленное на терминале. Для «Сбербанк UPOS3» — заполнить адрес и порт биллинга. | Через это ПО проходят оплаты, отмены и сверки по командам кассы. Протокол TTK2 при этом может работать с любым поддерживаемым банковским ПО, не только со Сбербанком. |
| Способы оплаты → Включить сверку, Время сверки итогов | По желанию. | Автоматическая ежедневная сверка. Её можно не включать, если сверку в конце смены запускает касса. |
| Способы оплаты → Включить СБП, Профиль СБП | По желанию. | Оплата по QR-коду на экране терминала по команде кассы. |
| Способы оплаты → Включить наличные | Не включать. | Наличные принимает касса. Включённый флажок добавит кнопку «Наличные» на экран выбора способа оплаты на терминале. |
| ККТ / поле «Фискализация» | Только если чек формирует JustPay. | См. Кто печатает чек и Фискализация и ККТ. |
Кто печатает чек: фискализация в связке с кассой
На одну покупку должен быть один фискальный чек. Выберите одну из схем и настройте под неё конфигурацию.
| Схема | Как работает | Что настроить в JustPay |
|---|---|---|
| Чек печатает касса самый частый вариант | Кассовая программа печатает фискальный чек на своей ККТ, JustPay проводит только банковскую операцию. Банковский слип касса печатает из ответа терминала. | В конфигурации снять «Фискализация безналичных операций» (и «наличных»), «Обязательность фискализации» — снята. «Отправлять операции на сервер» можно оставить: платежи будут видны в ЛК, но без чека JustPay. |
| Чек формирует JustPay | Касса передаёт состав чека по протоколу JUSTPAY, сервер JustPay регистрирует чек в облачной ККТ, привязанной к точке. Покупатель получает чек по QR-коду на экране терминала или на e-mail; касса получает ссылку на чек и фискальные данные. | Протокол «JustPay», «Отправлять операции на сервер» включено, «Фискализация безналичных операций» включена, к точке подключена ККТ — Фискализация и ККТ. «Таймаут показа чека» — 10–20 с. |
Решение о чеке JustPay принимает сервер по флажкам конфигурации «Фискализация безналичных операций» / «Фискализация наличных операций». Признак «нужна фискализация» в запросе кассы этого не отменяет. Если касса сама печатает чек, а флажки в конфигурации оставлены включёнными, JustPay сформирует второй чек — в том числе при работе по протоколу TTK2.
Что попадает в чек JustPay: позиции из запроса кассы (название, цена, количество, ставка НДС, признак агента и реквизиты получателя, если касса их передала) либо одна позиция из номенклатуры по умолчанию.
Смены, сверка, история и возвраты
У типа «POS-терминал» нет меню кассира на терминале: открытие и закрытие смены, история операций и возвраты ведутся в кассовой программе. JustPay дополняет это так:
| Действие | Как выполнить |
|---|---|
| Открыть / закрыть смену, история смен | В кассовой программе — на её ККТ. Меню кассира со сменами на терминале есть только в POS-точке — см. Приложение на терминале → Меню кассира. |
| Сверка итогов | Командой из кассы (обычно при закрытии смены); автоматически по «Времени сверки итогов» в карточке точки; заданием «Сверка итогов» из ЛК — Задания и сверка итогов. Результаты при включённой отправке на сервер видны в разделе «Сверки итогов». |
| Отмена / возврат оплаты картой | Из кассы — команда отмены с суммой и RRN исходной операции. Касса хранит RRN из ответа на оплату. Банк проводит отмену или возврат по своим правилам — сроки уточняйте в поддержке JustPay. Возврат операций, зарегистрированных в ЛК, — Возвраты и отмены. |
| История операций | В кассовой программе; при включённой отправке на сервер — в разделе Платежи личного кабинета. |
Пошаговая настройка
1. Подготовьте терминал и сеть
- Убедитесь, что на терминале установлено и активировано банковское ПО. Эквайринг и банковское ПО подключаются через JustPay: оставьте заявку (8 (800) 33 33 175 или /zayavka_help), и мы подадим заявку в банк, установим и активируем ПО. Сам терминал в ваш кабинет тоже добавляет техподдержка JustPay.
- Подключите терминал к сети точки (Wi-Fi или Ethernet) — Сеть терминала.
- Если касса на отдельном компьютере: закрепите за терминалом статический IP-адрес и попросите сетевого администратора разрешить подключение с компьютера кассы к этому адресу на порт протокола (по умолчанию 14200 или 8888), а терминалу — доступ в интернет к личному кабинету JustPay (lk.justpay.pro, HTTPS).
2. Создайте конфигурацию
- Конфигурации → Добавить. Тип конфигурации — «POS-терминал (прием платежей)», задайте Название (например, «Касса 1 — пин-пад»).
- Вкладка Настройки: Режим запуска — «Приложение» (касса на компьютере) или «Служба» (касса на терминале).
- Протокол — «JustPay» или «TTK2» (см. таблицу). Проверьте Порт для подключения; Тайм-аут не меняйте.
- Отправлять операции на сервер — оставьте включённым.
- Если чек формирует JustPay, а касса передаёт только сумму, — выберите Наименование номенклатуры (по умолчанию) и установите Использовать значение по умолчанию.
- Флажки фискализации — по выбранной схеме чека. Если чек печатает касса — снимите «Фискализация безналичных операций» и «Фискализация наличных операций».
- Вкладка Интерфейс → Первый экран: логотип и тексты экрана ожидания. Сохранить.
3. Настройте точку и привяжите терминал
- В карточке точки выберите созданную конфигурацию, на вкладке «Способы оплаты» включите оплату картой и выберите «Вид банковского ПО»; при необходимости — СБП и сверку. Для первой проверки можно выбрать «Эмулятор».
- Привяжите терминал к точке PIN-токеном — Токен и PIN-токен. Если терминал уже был привязан — отправьте задание «Обновление конфигурации».
4. Настройте кассовую программу
| Протокол | Что указать в кассовой программе |
|---|---|
| TTK2 | В настройках эквайринга кассы: тип эквайринга — «Сбербанк»; тип подключения — TCP/IP (по сети); адрес — IP-адрес терминала (127.0.0.1, если касса на самом терминале); порт — значение «Порт для подключения» (по умолчанию 8888). |
| JustPay | Адрес терминала и порт (по умолчанию 14200) в модуле интеграции с JustPay. Если интеграции в кассе ещё нет — её делает разработчик кассы по описанию протокола JUSTPAY (запросите в поддержке) либо используется платёжный модуль JustPay для кассовой программы по согласованию с поддержкой. |
Точные названия пунктов меню отличаются в разных кассовых программах (1С, БИФИТ Касса и др.) и их версиях — смотрите документацию своей кассы в разделе подключения платёжного терминала (пин-пада).
5. Проверьте
- С «Эмулятором»: проведите из кассы оплату на небольшую сумму. На терминале появится окно с кнопками «Подтвердить» и «Отменить» — нажмите «Подтвердить». Касса должна получить «успешно».
- Проверьте в ЛК, что платёж появился в разделе Платежи с правильной суммой и составом, и что чек сформирован (или не сформирован — если его печатает касса).
- Проведите из кассы отмену этой операции и сверку итогов.
- Смените «Эмулятор» на банковское ПО, отправьте задание «Обновление конфигурации» и проведите реальную оплату картой на минимальную сумму с последующей отменой.
Когда изменения дойдут до терминала
Параметры подключения к кассе (режим запуска, протокол, порт) терминал применяет при запуске приложения. После изменения конфигурации отправьте задание «Обновление конфигурации» или перезапустите приложение на терминале — Задания и сверка итогов. Если изменили порт — укажите новый порт и в кассовой программе.
Частые проблемы
| Что происходит | Причина | Что сделать |
|---|---|---|
| Касса пишет «нет связи с терминалом» / «пин-пад не найден» | Неверный IP-адрес или порт в кассе; терминал сменил адрес после перезагрузки роутера; порт закрыт в сети; на терминале не запущено приложение JustPay. | Сверьте адрес терминала и «Порт для подключения» с настройками кассы, закрепите статический IP, проверьте правила сети, перезапустите приложение. |
| Касса подключается, но оплата не начинается | Выбран протокол, который касса не понимает (например, в кассе эквайринг «Сбербанк», а в конфигурации — «JustPay»). | Для кассы с эквайрингом «Сбербанк» — протокол «TTK2» и порт 8888; для интеграции JustPay — «JustPay» и 14200. Отправьте «Обновление конфигурации». |
| Ошибка «Некорректная сумма по позициям…» | Касса передала состав чека, в котором цена × количество не равна сумме позиции или сумма позиций не равна итогу. | Исправить формирование запроса в кассе (обычно — округление копеек). |
| На терминале появляется экран выбора способа оплаты, хотя кассир уже выбрал «карта» | Касса не передаёт способ оплаты, а на точке включено несколько способов. | Настроить передачу способа оплаты в кассе или оставить на точке один способ. |
| На экране выбора есть кнопка «Наличные» | В карточке точки включены наличные. | Снять «Включить наличные» и отправить задание «Обновление конфигурации». |
| Два чека на одну покупку | Чек печатает касса, а в конфигурации включены флажки фискализации. | Снять «Фискализация безналичных операций» и «наличных». |
| Чек JustPay не формируется | Выключено «Отправлять операции на сервер» или флажки фискализации; к точке не подключена ККТ. | Проверьте конфигурацию и ККТ точки — Фискализация и ККТ. |
| В чеке позиция «Продажа» без ставки НДС | Касса передаёт только сумму, номенклатура по умолчанию не выбрана или не установлен флажок. | Выбрать номенклатуру по умолчанию и установить «Использовать значение по умолчанию». |
| Оплаты не видны в ЛК | Снят флажок «Отправлять операции на сервер»; у терминала нет интернета. | Включить флажок, проверить связь терминала — Диагностика. |
| Касса на терминале закрыта окном JustPay | Режим запуска «Приложение». | Выбрать «Служба», отправить «Обновление конфигурации». |
| Изменили настройки, а терминал работает по-старому | Терминал не перезапускал приложение. | Задание «Обновление конфигурации» или ручной перезапуск. |
| Карта «оплачивается» без списания, окно «Подтвердить / Отменить» | В точке выбран «Эмулятор». | Выбрать реальное банковское ПО, отправить «Обновление конфигурации». |
«Прием платежей» и «Курьер»: что это и чем отличаются
Эти типы стоят в списке рядом с POS-терминалом, но к вводу суммы кассиром и к работе с кассовой программой не относятся.
| Тип | Что делает терминал | Вкладки | Где описано |
|---|---|---|---|
| Прием платежей | Оплата начислений по реквизиту (лицевой счёт, номер договора, УИН): терминал показывает список начислений, полученных из внешней системы, карточку начисления с суммой и кнопками оплаты картой или по QR-коду. Вверху экрана — шапка приложения со списком платежей и заказов. | Общие данные, Настройки | Оплата услуг и заказов |
| Курьер | В текущей версии приложения терминала отдельного сценария для этого типа нет. Не выбирайте его без указания поддержки. Для оплаты заказов из вашей системы используйте оплату заказов или QR-стикер для оплаты заказов; для оплаты у клиента — Мобильный кассир. | Общие данные, Настройки | — |
Вкладка «Настройки» у «Прием платежей» и «Курьер»
У обоих типов один и тот же набор — только общие поля, без режима запуска, протокола и номенклатуры по умолчанию.
| Поле | Значение по умолчанию | Действует для «Прием платежей» |
|---|---|---|
| Сервер, Порт | адрес ЛК, 443 | Служебные, не меняйте. |
| Тип цены | не выбрано | Нет (только вендинг). |
| Тип первого экрана | Стандартный режим | Нет: первый экран — список начислений. |
| Тип экрана оплаты | Выбор способа оплаты | Нет (не используется приложением). |
| Таймаут главного экрана (сек), Таймаут выбора товара (сек) | пусто | Нет. |
| Таймаут показа чека (сек) | пусто | Да — время показа экрана результата; задайте 10–20 с. |
| Таймаут ожидания фискализации (сек) | 5 | Да, на сервере, вместе с «Обязательностью фискализации». |
| Таймаут оплаты по карте (сек) | 150 | Только с банковским ПО «SkyPos». |
| Таймаут оплаты по СБП (сек) | 150 | Да. |
| Тип экрана при сканировании Цифрового ID MAX | Отображать QR-код и одновременно сканировать Цифровой ID | Только при настроенной идентификации MAX. |
| Обязательность фискализации | снят | Да, на сервере. |
| Фискализация наличных операций, Фискализация безналичных операций | включены | Да: сервер формирует чек при подключённой к точке ККТ. |
Подробное описание каждого общего поля — Конфигурации → Вкладка «Настройки».