← QR Shop · Подключение через контроллер

Подключение по API без контроллера: когда это возможно

Иногда оплату по QR можно подключить вообще без установки чего-либо в аппарат: платёж сам отправляет команду в систему управления через интернет. Разбираем, в каких случаях это работает, как это проверить заранее и когда всё-таки нужен контроллер.

Комиссия — по тарифу ЮKassa: от 0,9% + НДС по СБП, от 2,3% + НДС картами разных банков, только за успешные платежи.
Не нужно покупать кассу и ККТ — чек по 54-ФЗ формируется автоматически.

Обычная схема подключения оплаты с телефона выглядит так: в аппарат ставится контроллер, и после успешного платежа он подаёт на плату такой же сигнал, как купюроприёмник или кнопка. Это надёжно и подходит почти к любому оборудованию. Но всё больше систем управления — у моек, парковок, турникетов, прачечных, вендинга — работают через облако и умеют принимать команды по сети. Тогда контроллер не обязателен: оплата может запустить услугу напрямую через API.

Что такое API простыми словами

API — это способ, которым одна программа отдаёт команды другой. Если у вашего оборудования есть личный кабинет в интернете, где можно посмотреть выручку, а ещё лучше — удалённо запустить пост или открыть шлагбаум, значит, у системы есть сервер, который понимает команды. При подключении по API после оплаты клиента наш сервис отправляет на этот сервер команду «начислить сумму» или «запустить услугу», и аппарат срабатывает. Физически на объекте ничего не меняется.

Когда подключение по API возможно

Оборудование подключено к интернету и управляется удалённо. Не просто передаёт статистику, а принимает команды: запуск, пополнение баланса, открытие.
У системы есть документация или производитель готов её дать. Без описания команд подключиться нельзя — угадывать протокол на работающем объекте никто не будет.
Есть нужная команда. Бывает, что API отдаёт только отчёты о выручке. Для оплаты нужна именно команда на начисление денег, времени или на запуск функции.
Владелец имеет доступ к своей учётной записи и может выдать ключ доступа или разрешение на подключение внешнего сервиса.

Когда без контроллера не обойтись

Старая плата без связи. Мойка на монетах или жетонах, пылесос с таймером, шлагбаум с кнопкой — у них просто нет канала, по которому можно передать команду.
Закрытая система. Производитель не раскрывает протокол и не пускает внешние сервисы. Тогда сигнал на запуск подаётся контроллером параллельно купюроприёмнику или кнопке.
Облако только для отчётов. Видеть выручку можно, управлять — нет.
Нестабильная связь на объекте. Если аппарат часто выпадает из сети, команда из облака может не дойти. Контроллер со своим подключением в такой ситуации предсказуемее.

Как проверить своё оборудование за 10 минут

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

API или контроллер: сравнение

	Подключение по API	Контроллер
Что ставится на объекте	Ничего, наше оборудование не нужно	Контроллер от 50 000 ₽ внутри аппарата
Подходит для	Облачных систем с открытыми командами	Почти любого оборудования, включая старое
Выезд на объект	Обычно не нужен	Нужен монтаж
От чего зависит работа	От облака производителя и связи аппарата	От связи контроллера и самого аппарата
Цены и режимы	Как настроены в системе управления	Как настроены в плате аппарата

Контроллер в любом случае дешевле платёжного терминала, поэтому даже там, где API нет, переход на оплату с телефона не превращается в замену оборудования.

Смешанная схема

На одном объекте часто стоят аппараты разных лет. Новые посты мойки работают через облако, а старый пылесос или ковромойка — на монетах. Ничто не мешает подключить первые по API, а вторые через контроллер. Для клиента разницы нет: он сканирует QR-код и платит по СБП или картой, а для владельца все оплаты собираются в одном отчёте.

Риски, о которых стоит знать

Зависимость от чужого сервера. Если облако производителя недоступно, запуск по оплате тоже не сработает. Перед подключением полезно узнать, как часто у системы бывают перебои.
Изменения API. Производитель может обновить систему и поменять команды. Поэтому интеграцию нужно сопровождать, а не настроить и забыть.
Деньги клиента. Если оплата прошла, а команда не дошла, клиенту нужно вернуть деньги или повторить запуск. Это продумывается до запуска, а не после первой жалобы.

Деньги, тариф и чеки

Схема оплаты не зависит от способа подключения. Платежи проходят через ЮKassa и зачисляются на ваш расчётный счёт. Комиссия — по тарифу ЮKassa: от 0,9% + НДС по СБП, от 2,3% + НДС картами разных банков, с успешного платежа. Не нужно покупать кассу и ККТ: чек по 54-ФЗ формируется автоматически и приходит клиенту в электронном виде.

API открывает и другие возможности

Применяется в местах, где необходимо предоставление контролируемого/платного доступа или услуг населению без наличия оператора: мойки самообслуживания, пылесосы, ковромойки, шлагбаумы и ворота, турникеты, платные туалеты, автоматические двери, массажные кресла, стиральные машины и вендинг. Если у системы есть API, через неё удобно автоматизировать и другие процессы: начислять бонусы постоянным клиентам, открывать доступ по абонементу, присылать уведомления. Мы делаем такие автоматизации и интеграции с CRM, чтобы каждая оплата и каждый клиент сразу попадали в вашу систему учёта.

Как обсудить подключение по API

Напишите название и производителя системы управления, которая стоит на объекте, и пришлите скриншот личного кабинета — особенно разделов с удалённым запуском и настройками интеграций. Если поддержка производителя уже ответила про API, перешлите этот ответ или документацию. Укажите, сколько аппаратов и каких лет выпуска у вас работает и есть ли среди них старые без связи. По этим данным скажем, можно ли подключиться программно без нашего оборудования, какие аппараты лучше перевести через контроллер и как свести все оплаты в один отчёт. Как устроен вариант с контроллером, подробно описано в статье Как контроллер запускает пост: импульс параллельно купюрнику или кнопке.

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

Можно ли подключить оплату по QR без установки оборудования?
Да, если система управления аппаратом работает через интернет и имеет API с командой на запуск или начисление суммы. Тогда наше оборудование не нужно.

Как понять, есть ли у моей мойки API?
Проверьте, можно ли в личном кабинете удалённо запустить пост или начислить бонус, и спросите у производителя про API для внешнего платёжного сервиса.

Что делать, если API нет?
Подключаемся через контроллер от 50 000 ₽: он подаёт сигнал на запуск параллельно купюроприёмнику или кнопке. Это дешевле платёжного терминала.

Нужна ли касса при подключении по API?
Не нужно покупать кассу и ККТ: чек по 54-ФЗ формируется автоматически при любой схеме подключения.

Какая комиссия при оплате по СБП?
Это тариф ЮKassa: от 0,9% + НДС по СБП, от 2,3% + НДС картами разных банков, с успешного платежа.

Что сделать дальше

Откройте бота QR Shop в MAX: там демо-оплата с телефона и заявка на расчёт под ваше оборудование. Опишите, что стоит на объекте, — подберём схему подключения.

Открыть бота: демо или заявка Позвонить +7 (977) 804-47-01

Канал QR Shop в MAX — короткие разборы без спама.
Подписаться на канал →