Официальный дистрибьютор WizarPOS в России — ООО «Джастпэй»op@justpay.proПн–пт 9:00–18:00Личный кабинет JustPay

API и интеграции

Разработчикам и интеграторам

Терминал WizarPOS с приложением JustPay встраивается в автомат, киоск или учётную систему несколькими способами: по MDB, через Pulse и реле, как пинпад по команде внешней системы или через открытый API. Ниже — что умеет каждый режим и как получить документацию.

Режимы интеграции

Режим зависит от того, кто управляет продажей: автомат, терминал или ваша система.

РежимКак работаетКогда подходит
MDBТерминал подключается к шине MDB автомата. Товар выдаётся только после успешной оплаты.Снековые и кофейные автоматы с MDB. Список проверенных моделей — в разделе совместимости.
PulseПосле оплаты терминал подаёт импульсный сигнал на оборудование.Автоматы без MDB и простые устройства самообслуживания с импульсным входом.
Реле и Digital I/OТерминал сам ведёт продажу и замыкает реле; входы принимают сигналы датчиков и кнопок.Замки, турникеты, шлагбаумы, дозаторы, пружинная выдача товара.
Терминал как пинпадВнешняя система отправляет заказ на оплату, терминал принимает карту или СБП и возвращает результат.Автомойки, паркоматы, билетные киоски и автоматы со своей системой управления.
Открытый APIВнешняя система получает данные о заказах, платежах и продажах.Учёт, отчётность, CRM, 1С, складские системы, собственная аналитика.

Как проходит оплата заказа из внешней системы

В этом режиме вся логика — тарифы, время, посты, билеты — остаётся в вашей системе. Терминал отвечает только за платёж.

  1. Ваша система создаёт заказ

    Она отправляет запрос на сервер JustPay: сумма, состав заказа, свой идентификатор, нужна ли фискализация.

  2. Терминал получает заказ

    Терминал опрашивает сервер и, получив заказ, показывает покупателю сумму.

  3. Покупатель платит

    Картой или по QR-коду СБП. Терминал проводит платёж и, если это задано в заказе, фискализирует его на кассе, привязанной к точке.

  4. Система узнаёт результат

    Ваша система запрашивает статус заказа до финального — оплачен или отменён — и запускает услугу: включает мойку, открывает шлагбаум, печатает билет.

Что умеет API заказов и платежей

  • Создание заказа

    Простой заказ на оплату товаров и услуг или расширенный — с данными плательщика и получателя платежа.

  • Статусы заказов

    Список заказов за период или сведения по одному заказу с текущим статусом.

  • Список платежей

    Платежи по точке за период и подробности по каждому платежу, включая способ оплаты — карта или СБП.

  • Фискализация

    В заказе указывается, нужно ли фискализировать платёж и печатать чек. Чек формирует онлайн-касса, привязанная к точке.

  • Оплата по ссылке

    Созданный заказ можно оплатить не только на терминале, но и на платёжной странице по ссылке из личного кабинета.

  • Связь с учётными системами

    Интеграция с внешними CRM и кассовыми программами, передача данных о продажах в сторонние системы.

Что нужно для подключения и как получить документацию

API работает по HTTPS и обменивается данными в формате JSON. Для запросов нужен токен доступа — он формируется в личном кабинете JustPay в настройках конкретной точки обслуживания.

  1. Оставьте заявку и коротко опишите задачу: какое оборудование, кто управляет продажей, какие данные нужны.
  2. Мы подберём режим интеграции и модель терминала, откроем аккаунт в личном кабинете.
  3. Вы получите описание протокола: аутентификация, создание заказа, получение списка заказов и списка платежей.
  4. Для отладки в личном кабинете есть режим эмулятора — платежи проходят без реального списания средств.

Адреса методов и ключи доступа выдаются вместе с документацией и на сайте не публикуются.

Управление оборудованием через реле

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

Многоканальные реле позволяют управлять большим числом ячеек или механизмов. Датчик закрытия двери возвращает терминалу сигнал о завершении покупки. Платы реле на 2, 4 и 16 каналов, замки и датчики собраны в разделе аксессуаров, перечень проверенных автоматов — на странице совместимости.

Терминалы для встраивания

Уличная модель с MDB и Digital I/O, встраиваемый модуль с Pulse и пинпад с большим экраном.

Производителям автоматов и интеграторам доступна партнёрская программа: оптовые цены и помощь в разработке решения. Условия — на странице «Партнёрам».

Вопросы и ответы

Как получить документацию по API JustPay?

Оставьте заявку с описанием задачи. Мы откроем аккаунт в личном кабинете и передадим описание протокола; токен доступа формируется в настройках точки обслуживания.

Можно ли использовать терминал только для приёма оплаты, без логики продаж?

Да, это режим пинпада: ваша система отправляет на терминал сумму и описание заказа, терминал принимает карту или СБП и возвращает результат.

Кто формирует кассовый чек при оплате заказа через API?

Онлайн-касса, привязанная к точке обслуживания. В заказе указывается, нужно ли фискализировать платёж и печатать чек.

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

Да. На небольшой автомойке или парковке один терминал в режиме пинпада может по очереди принимать запросы от разных постов.

Есть ли тестовый режим?

Да. В настройках способов оплаты в личном кабинете включается эмулятор: платежи проходят без реального списания средств.