Модуль 9 · Блок B · ~2 часа · критический модуль (проходной балл 100%)
Интеграция POS-терминала Kaspi / Halyk с iPad
Цель модуля: Научить настраивать связку Киоск (iPad) ↔ POS-терминал так, чтобы сумма передавалась корректно, оплата проходила и результат корректно возвращался для закрытия заказа.
Результаты обучения — после модуля специалист сможет:
  • проверять предусловия до начала настройки интеграции;
  • настраивать POS-терминал и iPad для совместной работы;
  • проводить тест передачи суммы и оплаты по полному сценарию;
  • диагностировать проблемы связи устройств без риска двойного списания.

Урок 9.1. Что должно быть готово до настройки

  • POS-терминал Kaspi или Halyk находится на точке;
  • терминал включается и подключён к питанию;
  • на точке есть стабильный интернет;
  • iPad и POS-терминал находятся в одной рабочей сети, если сценарий требует локальной связи;
  • для Ethernet-сценария известен IP терминала;
  • на iPad уже настроены Base URL, Cashier и Token;
  • в Dashboard выбраны правильная точка, терминальная группа, тип оплаты и константы.
Сервисные данные: Если для входа в админ-панель терминала нужны сервисные коды — использовать только закрытую внутреннюю инструкцию с ограниченными правами. Сервисные коды не переносятся в общие материалы, чаты и учебные документы.

Урок 9.2. Настройка терминала и iPad

Настройка POS-терминала
  1. Подключить POS-терминал к питанию.
  2. Проверить, что терминал включается.
  3. Проверить сеть на терминале.
  4. Если используется Ethernet — прописать IP терминала в настройках iPad / интеграции.
  5. Открыть админ-панель терминала.
  6. Включить режимы, необходимые для интеграции с Kiosk: защита интеграции и только интеграция.
  7. Принять Cashier в настройках доступа терминала.
  8. Сохранить настройки терминала.
  9. Перезапустить терминал, если после сохранения это требуется.
Настройка iPad для работы с терминалом
  1. Открыть настройки Kiosk на iPad.
  2. Проверить Base URL — только HTTPS.
  3. Проверить Cashier — в согласованном формате, на английском.
  4. Проверить Token — действующий и относящийся к нужной точке.
  5. Проверить IP терминала, если используется Ethernet.
  6. Проверить, что iPad видит POS-терминал.
  7. Закрыть и заново открыть приложение Kiosk.
  8. Проверить, что приложение открывается без ошибки авторизации.

Урок 9.3. Тест интеграции и критерий готовности

  1. Открыть Kiosk на iPad.
  2. Собрать тестовый заказ.
  3. Проверить итоговую сумму на iPad.
  4. Нажать оплату через нужный POS-сценарий.
  5. Убедиться, что сумма ушла на POS-терминал.
  6. Сверить сумму на POS с суммой заказа на iPad.
  7. Провести тестовую оплату.
  8. Проверить результат оплаты на iPad.
  9. Проверить чек, если по сценарию чек должен печататься.
  10. Проверить, что заказ появился в iiko.
  11. Проверить, что заказ корректно закрылся.
Критерий готовности интеграции: Интеграция считается готовой только если: сумма передаётся на POS, сумма совпадает с заказом, оплата проходит, чек и фискализация работают по сценарию, заказ появляется в iiko и закрывается без ошибки. Невыполнение любого пункта означает, что интеграция не готова.
Диагностика
СимптомРешение
Kiosk не авторизуется или не подключаетсяПроверить Base URL, Cashier, Token, интернет и корректность настроек устройства
POS не видит iPad или не принимает командыПроверить, что iPad и POS в одной сети; IP указан верно; на терминале включены режимы интеграции; Cashier принят в настройках доступа; терминал и iPad не зависли. Затем перезапустить терминал и iPad и повторить тест передачи суммы
POS не получает суммуПроверить сеть, IP, интеграционный режим POS, Cashier и связь iPad с POS. Перезапустить устройства и повторить тест — только если предыдущая транзакция точно не была начата
Сумма на POS неправильнаяОплату не проводить. Проверить сумму заказа, корзину, модификаторы, комбо и отсутствие старой попытки. Повторять оплату только после устранения расхождения
Главное правило модуля: Любое расхождение суммы — это риск неправильного списания у гостя. При расхождении оплата останавливается до выяснения причины, без исключений.

Практическое задание

  1. На демо-стенде пройдите полный тест интеграции по всем 11 пунктам и зафиксируйте результат каждого.
  2. Кейс: сумма заказа на iPad — 4 500 ₸, на терминале отображается 3 900 ₸. Опишите пошагово ваши действия и объясните, почему нельзя просто провести оплату и доплатить разницу отдельно.
Критерий прохождения: Тест 100% (число попыток не ограничено) + зачтён полный тест интеграции на демо-стенде.
Тест: вопросы этого модуля загружаются в Moodle отдельно, из банка вопросов (категория «Модуль 9»).