Банковские терминалы и эквайринг — 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. Нажмите кнопку рядом с галочкой — «Настройки» (у Kaspi и Alsep она называется «Тест подключения»). Откроется окно подключения терминала, где нужно указать:
   • IP Адрес — адрес терминала в локальной сети (узнайте его в меню терминала или у банка);
   • Вид оплаты — каким видом оплаты будет закрываться чек при оплате через этот терминал (по умолчанию — картой);
   • Ручное подтверждение (Да/Нет) — разрешить ли кассиру подтверждать оплату вручную, если терминал не прислал ответ. Настройка общая для всей кассы — она одна на все подключённые терминалы, из какого бы окна настроек её ни включили;
   • Номер терминала — необязательное поле: по нему касса находит в сети именно ваш терминал. Обычно заполнять вручную не нужно — после успешного теста подключения касса запоминает номер сама.
4. Нажмите «Тест подключения». Если всё в порядке, появится сообщение «Настройки успешно сохранены!». Если касса не видит терминал — «Терминал не подключен!»: проверьте IP-адрес и сеть. Кнопка «Отмена» в этом окне, как и неудачный тест, снимает галочку банка — терминал отключается, и его нужно включить и настроить заново.

IP-адрес можно не искать вручную. Кнопка «Поиск в сети» в том же окне сама находит терминал в локальной сети (поиск идёт до 30 секунд) и подставляет его адрес. Если найден один терминал — касса покажет «Найден терминал: …» с адресом и номером; если несколько — откроется список «Найденные терминалы», выберите свой (или «Искать ещё раз»); если никого нет — «Терминалы в сети не найдены». Когда номер терминала уже заполнен, касса ищет именно его: «Найден терминал № … по адресу …» или «Терминал № … в сети не найден». Предупреждение «Внимание: этот номер уже настроен как …» означает, что этот терминал уже привязан к другому банку в настройках кассы. После поиска нажмите «Тест подключения», чтобы сохранить адрес.

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

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

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

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

Если терминал не прислал ответ, касса сначала проверяет, на связи ли он по прежнему адресу. Терминал на связи — касса скажет «Терминал по адресу … на связи, но не ответил вовремя. Проверьте на терминале, прошла ли оплата, прежде чем повторять её.» или «На терминале выполняется операция: …». Терминал не отзывается (например, после перезагрузки роутера он получил новый IP) — касса спросит: «Отсутствует подключение с банковским терминалом! Провести автоматический поиск?» и при согласии сама найдёт терминал в сети и запомнит новый адрес. У Halyk, Forte, Freedom, Alatau и БЦК, если запрос до терминала вообще не дошёл и найден именно ваш терминал, касса повторит операцию сама («Терминал найден по адресу … Повторяю операцию...»); в остальных случаях она попросит проверить терминал и повторить операцию вручную — так исключается повторное списание.

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

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

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

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

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

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

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

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

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

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

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

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

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

QR-оплата

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

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

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

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

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

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

BePay — QR-оплата (Кыргызстан)

BePay — оплата по QR-коду для Кыргызстана. Терминал для неё не нужен: касса получает QR-код через облако Paloma365, поэтому нужен интернет. На вкладке «Плагины» ей соответствует галочка «BePay (QR, Кыргызстан)» — она не нажимается: сервис включается со стороны Paloma365 (если он не включён, рядом написано «BePay выключен в облаке»).

Кнопка «Настройки» открывает окно с полями «Merchant-id:», «Merchant-secret-key:» (ключи мерчанта, выданные BePay) и «Вид оплаты:». После «Применить» касса сохраняет ключи и проверяет их: «Настройки сохранены, ключи приняты шлюзом BePay» или «Проверка связи с BePay не прошла» с причиной. Без вида оплаты оплата BePay недоступна.

Как проходит оплата: кассир выбирает вид оплаты BePay, касса получает QR-код и печатает его на чековом принтере отдельным слипом — «Передайте слип клиенту. Ожидаем оплату...». На экране виден обратный отсчёт «Осталось: … сек». Клиент сканирует QR, касса дожидается подтверждения и закрывает чек. Если время вышло — «Истекло время ожидания оплаты. Если деньги списаны, подтвердите оплату вручную.»; кнопка «Оплатить вручную» видна, если включено «Ручное подтверждение». «Повторить» по ещё действующему QR не выпускает новый код, а перепечатывает слип (касса попросит забрать у клиента прежний). При закрытии окна касса предупредит, что клиент ещё может заплатить по выданному QR.

Ограничения:

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

Halyk Рестораны

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

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

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

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

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

FAQ

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

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

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

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

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

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