Банковские терминалы и эквайринг — Paloma365 Classic (касса для Windows)

Paloma365 Classic — кассовая программа для Windows — умеет работать с банковскими POS-терминалами напрямую: касса сама отправляет сумму на терминал Kaspi (Каспи), Halyk (Халык) или другого банка, а кассиру не нужно вручную вводить сумму на терминале. Это исключает ошибки ввода и ускоряет оплату.

Что решает банк, а что мы

Сам банковский терминал — оборудование БАНКА, у которого вы его получили. Мы отвечаем за то, как касса с ним разговаривает: настройку связи, отправку суммы, печать чека. За всё остальное отвечает банк, и обращаться нужно к нему:

• терминал не включается, не держит связь со своим процессингом, пишет ошибку банка;
• деньги списались, но не дошли до расчётного счёта; вопросы по срокам зачисления и комиссии;
• замена, ремонт, перепрошивка терминала, смена тарифа эквайринга.

Если непонятно, чья это сторона — напишите здесь: специалист посмотрит, дошла ли операция до кассы, и скажет прямо, идти в банк или чинить настройку у нас. «Проблема на стороне банка» — не отписка, а разделение зон: доступа к их процессингу у нас нет.

Поддерживаемые терминалы

• Kaspi
• Halyk (включая вариант «Halyk Рестораны» — подключение по коду сопряжения Pairing Code)
• Forte
• Freedom
• Alatau
• Alsep

Терминал подключается по локальной сети: касса и терминал должны находиться в одной сети (один роутер), связь идёт по IP-адресу терминала. Касса обращается к терминалу по порту 8080 — если в сети настроен файрвол, этот порт должен быть открыт.

Подключение терминала к кассе

1. Откройте настройки кассы (окно «Настройки Paloma365 — фронт офис»), вкладка «Плагины».
2. Включите галочку нужного банка, например «Использовать Kaspi» или «Использовать Halyk».
3. Нажмите кнопку «Настройки». Откроется окно подключения терминала, где нужно указать:
   • IP Адрес — адрес терминала в локальной сети (узнайте его в меню терминала или у банка);
   • Вид оплаты — каким видом оплаты будет закрываться чек при оплате через этот терминал (по умолчанию — картой);
   • Ручное подтверждение (Да/Нет) — разрешить ли кассиру подтверждать оплату вручную, если терминал не прислал ответ. Настройка общая для всей кассы — она одна на все подключённые терминалы, из какого бы окна настроек её ни включили.
4. Нажмите «Тест подключения». Если всё в порядке, появится сообщение «Настройки успешно сохранены!». Если касса не видит терминал — «Терминал не подключен!»: проверьте IP-адрес и сеть.

После настройки рядом с галочкой банка отображается IP терминала и привязанный вид оплаты.

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

1. Кассир собирает заказ и переходит к оплате.
2. Выбирает вид оплаты, привязанный к терминалу.
3. Касса отправляет сумму на терминал — на экране появится «Ожидание оплаты через терминал».
4. Клиент прикладывает карту (или оплачивает QR-кодом, если терминал это поддерживает).
5. При успехе касса покажет «Транзакция проведена успешно» и закроет чек с отметкой «Успешная оплата терминалом».

На терминал касса отправляет сумму, округлённую до целого (без тиынов/копеек) — поэтому сумма на терминале может незначительно отличаться от суммы чека.

Если оплата не прошла, касса покажет сообщение об ошибке (например, «Операция завершена неудачно» или ответ терминала) и предложит кнопки:

• «Повторить» — отправить оплату на терминал заново;
• «Оплатить вручную» — если оплата на терминале фактически прошла, а касса не получила ответ; появится вопрос «Подтвердите оплату на терминале». Для Kaspi кнопка видна, только если включено «Ручное подтверждение»; для остальных банков (Halyk, Forte, Freedom, Alatau, Alsep) кнопка отображается при оплате всегда;
• «Отмена» — вернуться к заказу.

Возврат на карту

Возврат тоже выполняется через терминал: при оформлении возврата касса показывает окно «Ожидание возврата через терминал». Для Kaspi кассир указывает:

• Вид оплаты — «Карта» или «QR код» (как платил клиент);
• Код транзакции — код исходной оплаты (касса подскажет: «Введите код транзакции»);

и нажимает «Возврат». Для Halyk код исходной транзакции касса подставляет автоматически из данных оплаты чека — если код найден, поле ввода не показывается; вводить код вручную нужно, только когда этих данных нет. Терминал Alsep при возврате запрашивает код транзакции: «Введите RRN».

Важно: для Forte и Freedom возврат в той же банковской смене, в которой прошла оплата, выполняется как отмена всей оплаты — частичный возврат в этой смене невозможен. Касса покажет сообщение: «Терминал HALYK поддерживает только полный возврат средств по чеку, выберите Все товары и повторите операцию» (текст сообщения упоминает HALYK, даже когда подключён Forte или Freedom). Выберите «Все товары» и повторите операцию — либо оформите частичный возврат после закрытия банковской смены.

Возврат без терминала

Если возврат на терминале не прошёл (терминал недоступен или вернул ошибку), касса спросит: «Провести возврат средств без использования терминала KASPI?» (вместо KASPI будет название вашего банка — HALYK, FORTE, FREEDOM, ALATAU или ALSEP) и покажет текст ошибки. Ответ «Да» — чек возврата будет оформлен в кассе без участия терминала; деньги на карту клиента при этом автоматически не вернутся, их нужно вернуть отдельно (например, провести возврат на самом терминале вручную). Ответ «Нет» — возврат прерывается.

Сверка итогов / закрытие дня

Для Halyk, Forte, Alatau и Freedom на вкладке «Плагины» есть кнопка «Закрыть смену» — она закрывает банковский день прямо с кассы, терминал печатает сверку итогов. Для Kaspi и Alsep такой кнопки в кассе нет — сверка выполняется на самом терминале.

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

• Терминал не отвечает (в настройках — «Терминал не подключен!», при оплате — сообщение «Ответ от терминала» с текстом ошибки): проверьте, что терминал включён, подключён к той же сети, что и касса, и что его IP-адрес не изменился (после перезагрузки роутера IP может смениться). Затем повторите «Тест подключения» в настройках.
• «Не корректный ответ от терминала» — терминал ответил, но касса не смогла разобрать ответ (он пришёл пустым или повреждённым). Проверьте связь между кассой и терминалом и повторите операцию; предварительно уточните на терминале, не прошла ли оплата.
• «Терминал ALSEP недоступен и будет отключен, проверьте настройки соедиения!» — касса периодически проверяет связь с терминалом Alsep; если терминал не отвечает, она показывает это сообщение и сама снимает галочку «Использовать Alsep». После восстановления связи включите галочку заново и выполните «Тест подключения».
• Оплата зависла («Ожидание оплаты через терминал» не заканчивается): проверьте на терминале, прошла ли оплата. Если прошла — нажмите «Оплатить вручную» и подтвердите; если нет — «Отмена» и повторите.
• Суммы кассы и терминала разошлись: сделайте закрытие смены на терминале (или кнопкой «Закрыть смену») и сравните сверку итогов с отчётами кассы. Причина чаще всего — оплата, проведённая на терминале вручную мимо кассы, либо не подтверждённая операция. Спорные транзакции уточняйте в банке.

QR-оплата

Kaspi и Halyk принимают оплату и по QR-коду — на кассе это тот же поток, что и оплата картой, а при возврате кассир выбирает «Карта» или «QR код».

Отдельный сервис Kaspi QR включается не в настройках кассы, а со стороны Paloma365 — касса получает признак его подключения из облака при входе в программу. Для работы Kaspi QR кассе нужен постоянный доступ в интернет.

Не печатается QR-код счёта на оплату

Сообщение «Ошибка печати QR кода (счета на оплату)!» появляется, когда касса не смогла напечатать счёт с QR-кодом. Следом идёт точный текст ошибки — по нему видно, что именно случилось:

• «Не найден файл отчета …» — на компьютере нет или повреждён шаблон печатной формы. Обновите программу: Установка и обновление.
• любой другой текст — не отработал сам принтер. Проверьте бумагу и связь с принтером, затем прогоните самодиагностику печати.

Сбой относится только к печати этой формы — счёта с QR-кодом; печать обычного чека идёт своим путём.

Halyk Рестораны

«Halyk Рестораны» — сервис оплаты заказов по QR-коду через Halyk. Он подключается по коду сопряжения (Pairing Code) и требует доступа кассы в интернет; признак подключения касса, как и для Kaspi QR, получает из облака при входе в программу. На вкладке «Плагины» сервису соответствует галочка «Использовать Halyk Рестораны».

Кнопка «Настройки» рядом с галочкой открывает окно подключения, где указываются:

• Pairing Code — код сопряжения (кнопка ввода открывает клавиатуру «Введите код»);
• Вид оплаты — каким видом оплаты будет закрываться чек (по умолчанию — картой, «КАРТОЙ»); наличные, депозит и «в долг» в списке не предлагаются;
• Меню — какое меню кассы использовать для сервиса.

Если подходящего вида оплаты ещё нет, его можно создать прямо с кассы: маленькая кнопка рядом с полем «Вид оплаты» открывает окно создания с полями «Наименование» (заполнено «Halyk Рестораны»), «Банковский счёт» и переключателем «Фискальный» (по умолчанию включён). Для создания нужен интернет — без связи появится «Отсутсвует интернет соединение...».

После нажатия «Применить» касса выполняет сопряжение с сервисом: при успехе появится «Рукопожание с Halyk Рестораны прошло успешно!», при ошибке — «Не удалось провести рукопожание с Halyk Рестораны» с текстом ответа сервиса (проверьте код сопряжения и интернет).

FAQ

Можно ли подключить несколько терминалов разных банков к одной кассе?

Да, каждый банк включается отдельной галочкой на вкладке «Плагины» и привязывается к своему виду оплаты.

Что делать, если после «Оплатить вручную» выяснилось, что оплата не прошла?

Оформите возврат или отмените чек по правилам вашего заведения и проведите оплату заново. Кнопку «Ручное подтверждение» можно отключить в настройках терминала, чтобы исключить такие случаи.

Почему касса перестала видеть терминал после замены роутера?

Терминал получил новый IP-адрес. Узнайте текущий IP терминала, впишите его в настройках («Настройки» → «IP Адрес») и нажмите «Тест подключения».