Эквайринг в Казахстане (Kaspi и Halyk) — Paloma POS 2

Эта статья про Paloma POS 2 — новую кассу-приложение линейки Paloma. Здесь описан приём оплаты картой в Казахстане через терминалы Kaspi и Halyk: как подключить платёжное устройство, оплатить картой и по QR, что такое Tap2Pay, как выбрать терминал при оплате и что делать при отказе или тайм-ауте. Если вы не уверены, какой у вас продукт, начните со статьи «Как понять, что у вас Paloma POS 2». Общий порядок приёма оплаты описан в статье «Оплата заказа».

Обзор

Оплата картой в Казахстане идёт через платёжное устройство (терминал), привязанное к кассе. Paloma POS 2 поддерживает несколько казахстанских интеграций:

• Kaspi — терминал Kaspi (в настройках варианты «Kaspi v2» и «Kaspi v3»).
• Halyk — несколько способов подключения: «Halyk PAX» и «Halyk (HTTP)» (физический терминал), «Halyk QR» (оплата по QR-коду), «Halyk Tap2Pay (SoftPOS)» (приём карты касанием телефона) и «Halyk restaurant».

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

Про фискальный чек (ОФД, QR на чеке) — см. «Фискализация в Казахстане». Про печать чека — «Принтеры и печать чека».

Как подключить платёжный терминал

Подключение выполняет администратор на устройстве, к которому подключён терминал:

1. Откройте «Настройки» → «Оборудование» → «Платёжные устройства».
2. Нажмите «Добавить устройство».
3. Выберите провайдера — например, «Kaspi v2», «Kaspi v3», «Halyk PAX», «Halyk (HTTP)», «Halyk QR» или «Halyk Tap2Pay (SoftPOS)».
4. Заполните поля подключения (у каждого провайдера они свои — например, у сетевых терминалов это адрес и порт терминала, у облачных — идентификаторы и ключи из личного кабинета банка).
5. Привяжите к устройству нужный вид оплаты. Если этого не сделать, в списке рядом с устройством будет написано «Не привязан ни к одному виду оплаты», и оплата картой через него не пройдёт.
6. Нажмите «Сохранить».

Терминал Kaspi/Halyk настраивают один раз. Если данные для подключения вы не знаете, возьмите их из личного кабинета банка или напишите нам — подключится специалист.

Привязка Halyk restaurant

Для варианта «Halyk restaurant» банк выдаёт одноразовый код привязки:

1. Заранее выберите ответственное рабочее место и привяжите к терминалу вид оплаты (иначе касса подскажет сделать это перед привязкой).
2. В карточке устройства в поле «Код привязки» введите код банка (не менее 6 символов — короткий код касса не примет).
3. Нажмите «Сохранить». Касса свяжется с банком и покажет результат: при успехе — «Привязка установлена.».

Если банк вернул ошибку, касса подскажет, что делать: проверить код и вид оплаты, войти заново или запросить у банка новый код привязки.

Оплата картой на терминале

1. В карточке заказа нажмите «Оплатить чек», затем «Карта».
2. Если к кассе привязано несколько терминалов, откроется окно «Выберите платёжный терминал» — выберите нужный (терминал по умолчанию отмечен значком «По умолчанию»).
3. Касса передаёт сумму на терминал и показывает «Вставьте карта / обработка...». Клиент прикладывает или вставляет карту в терминал.
4. Дождитесь ответа терминала. При успехе появится экран «Оплата завершена».

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

Оплата по QR (Halyk QR)

Для варианта «Halyk QR» клиент платит, сканируя QR-код своим приложением банка:

1. Нажмите «Оплатить чек» → «Карта» и, если нужно, выберите QR-терминал.
2. Касса покажет экран «Отсканируйте для оплаты» с подсказкой «Покажите QR клиенту и дождитесь оплаты».
3. Клиент сканирует QR и подтверждает оплату в своём приложении.
4. Когда банк подтвердит платёж, касса завершит чек — появится экран «Оплата завершена».

Точно так же работает возврат по QR: касса покажет «Отсканируйте для возврата».

Оплата касанием (Halyk Tap2Pay)

«Halyk Tap2Pay (SoftPOS)» превращает сам телефон или терминал кассы в приём бесконтактной карты — отдельное устройство не нужно. Клиент прикладывает карту или телефон к устройству кассы, и оплата проходит как обычная оплата картой. На экране оплаты нажмите «Карта» и приложите карту к устройству, когда касса покажет «Вставьте карта / обработка...».

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

• «Нет доступных терминалов» в окне выбора терминала — к кассе не привязан ни один платёжный терминал. Подключите терминал в «Настройки» → «Оборудование» → «Платёжные устройства» или примите оплату наличными.
• «Не привязан ни к одному виду оплаты» у устройства в списке — терминал добавлен, но к нему не привязан вид оплаты. Откройте устройство и привяжите вид оплаты, иначе оплата картой через него не пройдёт.
• «У вас нет прав на приём оплаты картой.» — у сотрудника нет права принимать оплату картой. Права настраивает администратор.
• «Ошибка карточного терминала. Повторите попытку.» — терминал вернул ошибку. Деньги не списаны; повторите или примите наличные.
• «Карта отклонена. Попробуйте другую карту или оплату наличными.» — банк отклонил карту клиента. Попробуйте другую карту или наличные.
• «Оплата картой отменена.» — операцию отменили на терминале. Заказ остался открытым — повторите оплату.
• «Тайм-аут карточного терминала. Проверьте устройство или отчёт по партии перед повтором.» — терминал не ответил вовремя. Прежде чем повторять, проверьте на терминале или в отчёте по партии, не прошла ли оплата, чтобы не списать дважды.
• «Оплата картой не прошла: терминал не в сети» — терминал выключен или в другой сети. Проверьте, что терминал включён и в одной сети с кассой. Деньги не списаны — повторите или примите наличные.
• «Оплата картой не прошла: нет связи с сетью» — касса не смогла определить адрес терминала. Проверьте подключение кассы к сети. Деньги не списаны — повторите или примите наличные.
• «Приём платежей на терминале заблокирован. Проверьте, что поверх интеграции не запущена Kaspi Kassa, или напишите нам — подключится специалист провайдера.» — поверх интеграции работает стороннее приложение Kaspi Kassa. Закройте его или напишите нам — подключится специалист провайдера.
• «Терминал не завершил предыдущую операцию. Завершите или отмените её на устройстве и повторите.» — на терминале «висит» незавершённая операция. Завершите или отмените её на самом устройстве и повторите оплату.

FAQ

Чем отличаются Kaspi v2 и Kaspi v3?

Это две версии интеграции с терминалом Kaspi. Какую выбрать, зависит от вашего терминала и договора с банком — при подключении администратор выбирает нужную версию в списке провайдеров («Kaspi v2» или «Kaspi v3»). Для кассира приём оплаты одинаков: нажать «Карта».

Чем Halyk QR отличается от обычной оплаты картой?

При «Halyk QR» клиент не прикладывает карту к терминалу, а сканирует QR-код своим приложением банка и подтверждает оплату в телефоне. Отдельный физический терминал для этого не нужен.

Что такое Tap2Pay и нужен ли для него терминал?

«Halyk Tap2Pay (SoftPOS)» — приём бесконтактной карты прямо устройством кассы, без отдельного терминала. Клиент прикладывает карту или телефон к устройству кассы, и оплата проходит как обычная оплата картой.

У меня несколько терминалов. Как выбрать нужный при оплате?

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

Терминал завис или не ответил. Деньги списались?

При тайм-ауте или отказе касса не списывает деньги и оставляет заказ открытым. Но если вы видите «Тайм-аут карточного терминала…», сначала проверьте на самом терминале или в отчёте по партии, не прошла ли оплата, и только потом повторяйте — так вы не спишете сумму дважды.

Можно ли принять часть картой, а часть наличными?

Да. Это обычная смешанная оплата — она работает одинаково для Kaspi и Halyk. Порядок описан в статье «Оплата заказа».