Активация API-ключа и как добавить коды услуг

API-ключ позволяет связать Stebby с вашей кассовой, бронировочной или торговой системой (например, Mobi, Noom, CompuCash, Booklux и т. д.).

NB! Активировать API ключ могут только Поставщики услуг, которые находятся в пакете Standard или Gold.

Как активировать API-ключ?

1. Войди в свой аккаунт поставщика услуг.
2. Перейди в раздел Продажи и услуги → Точки продаж.
3. Выбери нужную точку продаж и нажми Редактировать.
4. Прокрути страницу вниз и включи опцию API-ключ активирован.
5. Введи название используемой кассовой, бронировочной или торговой системы (например, CompuCash, Noom, Mobi, Booklux...).
6. Нажми на значок +, чтобы создать новый API-ключ.
7. Если ты уже создавал API-ключ ранее, добавь год в конец названия нового ключа (например, "CompuCash 2026"), чтобы тебе было проще их различать. После успешной интеграции нового ключа ты можешь удалить старый.
8. Нажав кнопку Показать ключи, ты увидишь все API-ключи, привязанные к твоей точке продаж.

Какой метод аутентификации покупок использовать?

API V4 поддерживает два разных сценария использования.

Токен (рекомендуется для онлайн-продаж)

Решение на основе токена предназначено для интернет-магазинов и сред самообслуживания. Пользователь надежно аутентифицируется через Stebby и дает твоей системе разрешение совершать транзакции Stebby от его имени. В результате Пользователю не нужно вводить свой личный код на твоем сайте, а поставщику услуг не требуется хранить чувствительные персональные данные в своей системе.

Решение на основе токена позволяет:

• Безопасно идентифицировать пользователя;
• Использовать средства Stebby прямо в корзине покупок;
• При необходимости комбинировать оплату через Stebby с доплатой на стороне твоего интернет-магазина;
• Избежать ручного ввода кодов билетов или промокодов.

Прочитай подробнее: процесс идентификации

EST_PIN (для кассовых систем)

EST_PIN предназначен для физических кассовых систем, в которых кассир ищет клиента прямо через кассу по его личному коду. Эта функция не включена по умолчанию для новых API-ключей. Если ты хочешь использовать поиск клиентов в своей кассовой системе, напиши нам на info@stebby.eu.

Как добавить коды услуг?

После настройки интеграции код услуги из твоей кассовой системы необходимо добавить к каждой продаваемой услуге.

1. В аккаунте поставщика услуг перейди в раздел Продажи и услуги → Точки продаж.
2. Нажми кнопку Редактировать рядом с соответствующей точкой продаж, а затем в открывшемся окне нажми кнопку Управление услугами точки продаж.
3. Введи код, полученный из кассовой системы, в поле "Код API" в строке услуги.
4. Убедись, что перед кодом и после него нет пробелов.
5. Сохрани каждый код отдельно с помощью зеленой галочки в конце строки.

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

Как найти техническую документацию?

Документацию по API и технические руководства для разработчиков ты найдешь в документации Stebby API. Если тебе нужны права доступа к EST_PIN или помощь с настройкой, напиши нам по адресу info@stebby.eu.