Не нашли ответ?Поддержка JustPay на связи в рабочие дни с 7:00 до 18:00 (МСК).

POS-терминал и касса

Конфигурация типа «POS-терминал (прием платежей)» превращает терминал JustPay в платёжный терминал для кассовой программы: касса (1С, БИФИТ Касса, учётная система, паркомат) передаёт сумму, терминал проводит оплату картой или по СБП и возвращает кассе результат. Здесь — как это устроено, каждое поле настроек, кто печатает чек, пошаговая настройка и частые проблемы. В конце — чем от этого типа отличаются «Прием платежей» и «Курьер».

  • Где: Конфигурации → Добавить → Тип конфигурации «POS-терминал (прием платежей)»
  • Кому: администратору, технику, разработчику кассовой интеграции
  • Действует на: терминал точки, кассовую программу, платежи и чеки в ЛК

Что такое POS-терминал в JustPay

У типа «POS-терминал (прием платежей)» нет каталога, планограммы и экранов выбора товара. Терминал ждёт команду от внешней системы — кассовой программы — и выполняет её через банковское ПО, установленное на терминале. Сумму и состав чека задаёт касса, а не терминал.

  1. Касса: сумма и состав чека
  2. Терминал JustPay: способ оплаты
  3. Банковское ПО: карта или СБП
  4. Сервер JustPay: регистрация и чек
  5. Ответ кассе

Место типа в общей схеме — как у любого сценария: Место обслуживания → Точка (способы оплаты, банковское ПО, касса для чеков) → Конфигурация (этот тип) → терминал.

ЗадачаКакой тип выбрать
Терминал стоит рядом с кассой (или касса установлена на самом терминале), сумму передаёт кассовая программаPOS-терминал (прием платежей) — эта статья
Кассир сам набирает товары или свободную сумму на экране терминала, нужно меню кассира (смены, история, возврат)POS-точка — каталог, корзина, свободная цена, меню кассира
Покупатель сам вводит произвольную сумму (пожертвование, оплата услуги без кассы)Пожертвования (кнопка «Ваша сумма»)
Оплата начислений по лицевому счёту, договору, УИН«Прием платежей» — ниже и Оплата услуг и заказов

Сумму на самом терминале в этом типе не вводят. Экран терминала — это экран ожидания с логотипом и текстами; кнопок ввода суммы и меню кассира на нём нет. Если нужен «пин-пад, на котором продавец набирает сумму», используйте POS-точку со свободной ценой.

Два сценария работы с кассой

Терминал рядом с кассой (касса на компьютере)

Кассовая программа работает на компьютере или моноблоке, терминал JustPay стоит рядом и подключён к той же локальной сети (Wi-Fi или Ethernet). Касса обращается к терминалу по сети: IP-адрес терминала + порт из конфигурации. На терминале постоянно открыт экран ожидания JustPay; во время оплаты на нём появляется экран оплаты.

Рекомендуемый Режим запуска — «Приложение». Терминалу нужен постоянный (статический) IP-адрес в сети — иначе после перезагрузки роутера касса его «потеряет». См. Статический IP и DHCP.

Касса установлена на самом терминале

Кассовое приложение (например, БИФИТ Касса или 1С Мобильная касса) установлено прямо на POS-терминал. Тогда JustPay работает в фоне, а касса обращается к нему по адресу 127.0.0.1 (тот же терминал) и порту из конфигурации. Окно JustPay появляется поверх кассы только на время оплаты и само закрывается после неё.

Рекомендуемый Режим запуска — «Служба».

В обоих сценариях на терминале должно быть установлено и активировано банковское ПО банка-эквайера, а в карточке точки выбран соответствующий «Вид банковского ПО» — см. Способы оплаты. Эквайринг подключает JustPay: по вашей заявке мы сами подаём заявку в банк, устанавливаем и активируем банковское ПО. JustPay не заменяет банковское ПО, а вызывает его.

Как проходит оплата

  1. Касса формирует запрос. Кассир пробивает товары в кассовой программе и выбирает оплату картой. Касса отправляет на терминал команду «оплата» с суммой; по протоколу JUSTPAY — ещё и состав чека, имя кассира и, при необходимости, способ оплаты.
  2. Терминал выбирает способ оплаты. Если касса указала способ (карта или СБП), терминал сразу переходит к нему. Если не указала и на точке включено несколько способов — покупатель видит экран «Выберите способ оплаты».
  3. Оплата. Картой — открывается банковское приложение, покупатель прикладывает карту. По СБП — на экране терминала появляется QR-код, покупатель оплачивает его в приложении своего банка.
  4. Регистрация в JustPay. Если в конфигурации включено «Отправлять операции на сервер», терминал регистрирует платёж в личном кабинете; сервер формирует чек, если это предусмотрено настройками фискализации.
  5. Ответ кассе. Терминал возвращает кассе результат: успешно или отказ с кодом и текстом ответа банка, номер операции (RRN), код авторизации, маскированный номер карты и текст банковского слипа. При регистрации в JustPay — ещё ссылку на чек и, по запросу кассы, QR-код чека и фискальные данные.
  6. Касса завершает продажу. Касса печатает слип и (если чек печатает она) фискальный чек, закрывает документ продажи.

Так же, по команде кассы, выполняются отмена/возврат (касса передаёт сумму и RRN исходной операции) и сверка итогов.

Как это влияет на терминал

Экраны оплаты, QR-кода СБП, проведения платежа, успеха и ошибки — общие для всех сценариев, их вид настраивается на вкладке «Интерфейс» и описан в статье Приложение на терминале. Время показа экрана результата задаёт поле «Таймаут показа чека (сек)».

Как это выглядит на стороне кассы

Если касса подключена через платёжный модуль JustPay для кассовой программы (поставляется по согласованию с поддержкой), порядок такой:

  1. Кассовая программа вызывает платёжный модуль; на экране кассы появляется окно «ОПЛАТА на сумму …» с выбором способа: Банковской картой (клавиша 1), QR-код СБП (клавиша 2). Отменить — Esc закрывает окно без оплаты.
  2. После выбора команда уходит на терминал, в окне модуля — «Ожидайте — операция выполняется. Идёт соединение с банком».
  3. При успехе — «ОПЛАТА УСПЕШНО»; модуль передаёт кассе код ответа и образ чека (слипа), касса печатает его на своём принтере.
  4. При отказе — «ОШИБКА» и код ответа банка с расшифровкой (например, «нет связи с банком»).

Отмена операции по карте выглядит так же: окно «Отмена на сумму …», по результату — «ОТМЕНА УСПЕШНО» или «ОШИБКА» с кодом.

Протоколы: чем касса «разговаривает» с терминалом

Протокол выбирается в поле Протокол на вкладке «Настройки» конфигурации. Для работы с кассой используются два.

ВозможностьJustPay (протокол JUSTPAY)TTK2 (эмуляция протокола Сбербанка)
Для каких кассКасса или учётная система, в которую встроена интеграция с JustPay (делает её разработчик кассы по описанию протокола)Любая касса, умеющая работать с пин-падом Сбербанка по сети (TCP/IP): в ней выбирают эквайринг «Сбербанк», а терминал JustPay «притворяется» пин-падом
Порт по умолчанию142008888
Оплата, отмена, возврат, сверка итоговДаДа
Передача состава чека (товары, количество, ставки НДС, кассир, 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-терминал (прием платежей)», Название, Описание, Наименование клиента; Дата версии, Версия и Статус — служебные. Подробно — Конфигурации → Общие данные. У этого типа три вкладки: «Общие данные», «Настройки», «Интерфейс».

Новая конфигурация: тип «POS-терминал (прием платежей)», вкладки Общие данные, Настройки, Интерфейс
Создание: тип выбран, у формы три вкладки
Заполненная конфигурация POS-терминала: статус «Активная», версия, название
Сохранённая конфигурация: появились дата версии, номер версии и статус

Тип у существующей конфигурации технически изменить можно, но делать этого не следует: смена типа может нарушить логику работы терминала. Нужен другой сценарий — создайте новую конфигурацию нужного типа.

Вкладка «Настройки»: каждое поле

Ниже — все поля вкладки в том порядке, в каком они идут в ЛК. Поля, общие для всех типов, описаны кратко — подробнее в статье Конфигурации; поля, важные именно для работы с кассой, — подробно.

Вкладка «Настройки» новой конфигурации POS-терминала: Режим запуска, Протокол, Порт для подключения, Тайм-аут, Отправлять операции на сервер
Новая конфигурация: значения по умолчанию
Вкладка «Настройки» рабочей конфигурации 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-терминала: блоки Первый экран, Экран ошибки, Последний экран
Три блока; каждый раскрывается стрелкой справа

Все поля блоков, форматы цветов и картинок — Оформление экранов терминала.

Карточка точки: что настроить для 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. Подготовьте терминал и сеть

  1. Убедитесь, что на терминале установлено и активировано банковское ПО. Эквайринг и банковское ПО подключаются через JustPay: оставьте заявку (8 (800) 33 33 175 или /zayavka_help), и мы подадим заявку в банк, установим и активируем ПО. Сам терминал в ваш кабинет тоже добавляет техподдержка JustPay.
  2. Подключите терминал к сети точки (Wi-Fi или Ethernet) — Сеть терминала.
  3. Если касса на отдельном компьютере: закрепите за терминалом статический IP-адрес и попросите сетевого администратора разрешить подключение с компьютера кассы к этому адресу на порт протокола (по умолчанию 14200 или 8888), а терминалу — доступ в интернет к личному кабинету JustPay (lk.justpay.pro, HTTPS).

2. Создайте конфигурацию

  1. Конфигурации → Добавить. Тип конфигурации — «POS-терминал (прием платежей)», задайте Название (например, «Касса 1 — пин-пад»).
  2. Вкладка Настройки: Режим запуска — «Приложение» (касса на компьютере) или «Служба» (касса на терминале).
  3. Протокол — «JustPay» или «TTK2» (см. таблицу). Проверьте Порт для подключения; Тайм-аут не меняйте.
  4. Отправлять операции на сервер — оставьте включённым.
  5. Если чек формирует JustPay, а касса передаёт только сумму, — выберите Наименование номенклатуры (по умолчанию) и установите Использовать значение по умолчанию.
  6. Флажки фискализации — по выбранной схеме чека. Если чек печатает касса — снимите «Фискализация безналичных операций» и «Фискализация наличных операций».
  7. Вкладка Интерфейс → Первый экран: логотип и тексты экрана ожидания. Сохранить.

3. Настройте точку и привяжите терминал

  1. В карточке точки выберите созданную конфигурацию, на вкладке «Способы оплаты» включите оплату картой и выберите «Вид банковского ПО»; при необходимости — СБП и сверку. Для первой проверки можно выбрать «Эмулятор».
  2. Привяжите терминал к точке PIN-токеном — Токен и PIN-токен. Если терминал уже был привязан — отправьте задание «Обновление конфигурации».

4. Настройте кассовую программу

ПротоколЧто указать в кассовой программе
TTK2В настройках эквайринга кассы: тип эквайринга — «Сбербанк»; тип подключения — TCP/IP (по сети); адрес — IP-адрес терминала (127.0.0.1, если касса на самом терминале); порт — значение «Порт для подключения» (по умолчанию 8888).
JustPayАдрес терминала и порт (по умолчанию 14200) в модуле интеграции с JustPay. Если интеграции в кассе ещё нет — её делает разработчик кассы по описанию протокола JUSTPAY (запросите в поддержке) либо используется платёжный модуль JustPay для кассовой программы по согласованию с поддержкой.

Точные названия пунктов меню отличаются в разных кассовых программах (1С, БИФИТ Касса и др.) и их версиях — смотрите документацию своей кассы в разделе подключения платёжного терминала (пин-пада).

5. Проверьте

  1. С «Эмулятором»: проведите из кассы оплату на небольшую сумму. На терминале появится окно с кнопками «Подтвердить» и «Отменить» — нажмите «Подтвердить». Касса должна получить «успешно».
  2. Проверьте в ЛК, что платёж появился в разделе Платежи с правильной суммой и составом, и что чек сформирован (или не сформирован — если его печатает касса).
  3. Проведите из кассы отмену этой операции и сверку итогов.
  4. Смените «Эмулятор» на банковское ПО, отправьте задание «Обновление конфигурации» и проведите реальную оплату картой на минимальную сумму с последующей отменой.
Список платежей в личном кабинете
Платежи по командам кассы появляются здесь, если включено «Отправлять операции на сервер»

Когда изменения дойдут до терминала

Параметры подключения к кассе (режим запуска, протокол, порт) терминал применяет при запуске приложения. После изменения конфигурации отправьте задание «Обновление конфигурации» или перезапустите приложение на терминале — Задания и сверка итогов. Если изменили порт — укажите новый порт и в кассовой программе.

Частые проблемы

Что происходитПричинаЧто сделать
Касса пишет «нет связи с терминалом» / «пин-пад не найден»Неверный 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.
Обязательность фискализацииснятДа, на сервере.
Фискализация наличных операций, Фискализация безналичных операцийвключеныДа: сервер формирует чек при подключённой к точке ККТ.

Подробное описание каждого общего поля — Конфигурации → Вкладка «Настройки».

Что дальше