Обзор платформы¶

Что такое Sagi¶

Sagi — это платформа лояльности для бизнеса, которая позволяет интегрировать бонусную программу в кассовые системы и POS терминалы.

Платформа объединяет: - Мобильное приложение для клиентов (iOS/Android) - Веб-платформу для управления бизнесом - REST API для интеграции с кассовыми системами

Архитектура¶

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   POS Terminal  │◄──►│   Sagi API      │◄──►│ Mobile App      │
│   (Ваша касса)  │    │ gateway.sagi.kz │    │ (Клиенты)       │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │   Веб-панель    │
                    │  (Бизнес-admin) │
                    └─────────────────┘

Кассовая система взаимодействует с Sagi API для начисления и списания бонусов при каждой покупке. Клиент видит свой баланс и историю в мобильном приложении. Бизнес управляет настройками через веб-панель.

Среды¶

Среда	URL	Назначение
Production	`gateway.sagi.kz`	Рабочая среда
Sandbox	`test.sagi.kz`	Тестирование интеграций

Основные сущности¶

Клиенты¶

Регистрация по номеру телефона (+77XXXXXXXXX). Каждый клиент имеет персональный бонусный баланс в каждом филиале бизнеса.

Филиалы и группы¶

branch_id — уникальный ID конкретного филиала
group_id — общий ID для всех филиалов одного бизнеса

Бонусы клиента объединяются по group_id: клиент может накопить бонусы в одном филиале и потратить в другом того же бизнеса.

Бонусы¶

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

Поддержка¶

При возникновении вопросов: WhatsApp +7 775 700 0030