Sagi API#

Добро пожаловать в документацию интеграции Sagi (loyalty bonus system) для кассовых систем и POS терминалов.

Система Sagi предоставляет полнофункциональную API для интеграции бонусной программы лояльности, включающую:

  • Аутентификацию бизнес-пользователей с JWT токенами

  • Поиск и управление клиентами по номеру телефона

  • Начисление и списание бонусов с поддержкой кодов подтверждения

  • Систему штампов и наград для программ лояльности

  • Полные рабочие процессы для интеграции с POS системами

  • Обработку ошибок и рекомендации по отказоустойчивости

Быстрый старт#

  1. Получите доступ: Запросите учетные данные для API у команды Sagi

  2. Авторизуйтесь: Используйте /api/v1/auth/business для получения JWT токена

  3. Настройте филиал: Получите branch_id и group_id для работы с бонусами

  4. Интегрируйте: Следуйте пошаговым сценариям работы в разделе «Рабочие процессы»

Swagger API#

Для интерактивного тестирования API используйте Swagger UI:

https://gateway.sagi.kz/api/v1/swagger/index.html

Swagger предоставляет полную OpenAPI спецификацию со всеми эндпоинтами, параметрами и возможностью выполнить запросы прямо в браузере.

Содержание