Оплата Kaspi в автоматах самообслуживания

Любая точка без продавца может принимать оплату через Kaspi и сама запускаться в момент поступления денег: пост автомойки самообслуживания, водомат, цветочный автомат с открывающейся дверцей, книжная полка без продавца. Оператору не нужно смотреть в телефон и проверять, пришли ли деньги.

Qut Pay создаёт счёт, следит за оплатой и сообщает вашей системе «оплачено». Деньги приходят сразу на ваш счёт Kaspi Pay. Qut Pay деньги не держит.

Qut Pay — программный сервис. Мы не продаём и не устанавливаем автоматы, контроллеры и MDB-модули. «Железную» часть, которая управляет автоматом, делаете вы или ваш интегратор. Эта страница — инструкция для такой работы.

Коротко: какой автомат каким способом

Какие автоматы самообслуживания бывают

Список охватывает типы, которые часто встречаются в Казахстане. Внутри одного типа способ управления зависит от производителя, поэтому посмотрите плату или документацию своего автомата.

A. Автомат с экраном: API и QR на экране

Автомат или его сервер создаёт счёт через POST /api/v1/invoices и выводит на экран картинку qrImageUrl. Клиент сканирует её в Kaspi.kz и платит. Об оплате автомат узнаёт по webhook или опрашивает GET /api/v1/invoices/{id} каждые 2–3 секунды. Каждый счёт новый, QR действует около 3 минут.

Полная инструкция с примерами запросов и правилами хранения ключа: Подключите оплату Kaspi к своему устройству через API.

B. Автомат с импульсным управлением: постоянный QR и импульсный модуль

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

1. В кабинете в разделе Ссылки создаёте для каждого поста или автомата отдельную постоянную ссылку оплаты, например qut.kz/p/moika-post-3. Сумму фиксируете (500 ₸) или оставляете клиенту. Во втором случае можно задать минимум и максимум, например от 200 до 5 000 ₸.
2. Печатаете QR этой ссылки и клеите на пост.
3. Клиент сканирует QR камерой телефона, выбирает сумму и подтверждает оплату в Kaspi.
4. Qut Pay отправляет на ваш сервер событие invoice.paid. В нём есть metadata.slug, по нему вы понимаете, какой это пост.
5. Сервер даёт команду модулю этого поста. Модуль выдаёт импульсы по сумме: если 1 импульс равен 10 ₸, то за 500 ₸ это 50 импульсов.

Тело webhook в сокращённом виде:

{
  "event": "invoice.paid",
  "invoice": {
    "id": "inv_…",
    "status": "paid",
    "amount": 500,
    "metadata": { "paymentLinkId": "pl_…", "slug": "moika-post-3" }
  }
}

Модуль. Обычно это ESP32 или Raspberry Pi с оптроном или реле. Он подключается параллельно сигнальному проводу монетоприёмника, и автомат принимает его как брошенную монету. Модуль сам подключается к серверу (MQTT или HTTP-опрос), поэтому на посту подойдёт и интернет через GSM-модем. Подключать провода лучше специалисту, который знает схему автомата.

C. Автомат с открывающейся дверцей: QR на каждую дверцу и реле

Цветочный автомат, умный холодильник, ячейки хранения, платный туалет открываются электрозамком.

• Цена постоянная (ячейка, туалет, парковка): на каждую дверцу или ячейку делаете одну ссылку с фиксированной суммой. После оплаты сервер по metadata.slug включает реле этой дверцы на несколько секунд.
• Цена меняется (цветы, товары в холодильнике): наклейка ведёт на вашу собственную страницу, например ваш-сайт.kz/cell/12. Страница показывает текущую цену ячейки и создаёт счёт через POST /api/v1/invoices с metadata: { "cell": 12 }. После оплаты открывается эта ячейка.

Если ячейка пустая, ссылку можно приостановить в кабинете. Клиент, открыв её, увидит сообщение, что ссылка временно приостановлена.

D. Вендинговый автомат с MDB

Снековые, питьевые и кофейные автоматы чаще всего принимают карты и QR через cashless-устройство на шине MDB. Нужен модуль в роли MDB cashless, на рынке есть готовые MDB-платы. Программа модуля создаёт счёт через Qut Pay API, когда клиент выбрал товар, выводит QR на небольшой экран и после подтверждения оплаты разрешает автомату продажу.

Это работа интегратора, Qut Pay здесь только создаёт и подтверждает оплату. Если у поставщика вашего автомата есть свой QR-модуль, сравните цену и условия.

E. Магазин без продавца и книжная полка

Самый простой вариант, «железо» не нужно.

• Создаёте одну ссылку, где клиент сам вводит сумму, при желании добавляете поле «Комментарий» (например, чтобы написать название книги).
• Клеите QR на полку или дверь. Цена указана на каждом товаре.
• Каждая оплата видна в кабинете, о ней сообщает Telegram-бот. Сразу видно, кто, сколько и за что заплатил.

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

Что нужно знать заранее

• Проверяйте подпись webhook. Без проверки кто-то может отправить поддельное «оплачено» и запустить пост бесплатно. Подпись: HMAC-SHA256, проверяется по телу в неизменном виде.
• Один счёт — один запуск. Если не получит ответ 2xx, webhook повторяется до 11 раз. Выдавайте импульсы или открывайте дверцу один раз на invoice.id.
• Бывает поздняя оплата. Если деньги пришли на счёт с истёкшим сроком, invoice.paid придёт с пометкой late: true. Выдайте услугу или верните деньги.
• Нужен интернет. Связь должна быть на сервере и в модуле, а также у клиента в телефоне.
• Связь с Kaspi может прерваться. Если кто-то войдёт в Kaspi Pay с номера кассира, оплата через Kaspi не пойдёт, пока кассира не переподключат. Уведомление придёт в Telegram. Не убирайте запасной способ оплаты: монеты, купюры или карту.
• Число ссылок ограничено. Число постоянных ссылок зависит от тарифа: Старт — 50, Бизнес — 300, Про — 1 000. Если автоматов больше, создавайте счёт через API со своей страницы, как в способах A и C.
• Каждый открытый счёт учитывается. Даже если клиент не заплатил, счёт входит в месячный лимит тарифа.
• Фискальный чек. Выдавать чек обязан продавец. Если в Kaspi Pay подключена Kaspi Касса, при оплате счёта Qut Pay чек сам приходит клиенту в приложение Kaspi. Подробнее: инструкция по фискальному чеку.
• Qut Pay — независимый сервис, который работает через роль «Кассир» в вашем собственном аккаунте Kaspi Pay. Мы не аффилированы с АО «Kaspi Bank». Риски описаны открыто: центр доверия.

Сколько стоит

7 дней бесплатно, отсчёт начинается с первого реального счёта. Дальше тариф выбирается по числу счетов в месяц:

Например, на автомойке с 6 постами и примерно 40 оплатами на пост в день выходит около 7 000 счетов в месяц, то есть тариф «Про». Платформа не берёт процент с оплаты. Kaspi удерживает свою комиссию отдельно (за QR 0,95 %), так же как и без нас. Подробнее: тарифы.

С чего начать

1. Зарегистрируйтесь на qut.kz и подключите кассира Kaspi: инструкция по подключению.
2. В кабинете в разделе Интеграции добавьте адрес webhook и сохраните секрет на сервере.
3. Если используете API, сначала проверьте всё в sandbox с ключом qp_test_…: оплату имитирует POST /invoices/{id}/simulate, webhook приходит по-настоящему.
4. Начните с одного поста или одной ячейки: реальной оплатой на 100 ₸ проверьте, что импульс или дверца работают правильно.
5. Затем подключайте остальные автоматы.

Код модуля и сервера можно поручить ИИ-агенту. Дайте Claude, Cursor или ChatGPT ссылку api.qut.kz/for-ai, оттуда он прочитает API Qut Pay.

Частые вопросы

Qut Pay сам устанавливает автомат или модуль?

Нет. Qut Pay — только программный сервис: создаёт счёт, следит за оплатой, отправляет webhook. Модуль, провода и программу автомата делаете вы или ваш интегратор.

Как показать QR, если у автомата нет экрана?

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

Как быстро автомат запустится после оплаты?

Обычно webhook приходит в течение 5 секунд после оплаты. К этому добавляется время ответа вашего сервера и модуля.

Может ли клиент на автомойке сам выбрать сумму?

Да. Если сумма в ссылке не зафиксирована, клиент вводит её сам. Можно задать минимум и максимум. Сервер считает число импульсов по пришедшей сумме.

Что будет, если связь с Kaspi прервётся?

Пока кассира не переподключат, новые оплаты через Kaspi не проходят. В Telegram придёт уведомление, переподключение в кабинете занимает несколько минут. Поэтому запасной способ оплаты в автомате (монеты, купюры, карта) лучше оставить.

Обновлено: 2026-11-11