Интернет-магазин и приложения

С помощью Gigma вы можете показать каталог на своём сайте или в приложении, рассчитать корзину, создать заказ и принять оплату. Интерфейс остаётся на вашей стороне, а Gigma хранит товары, остатки, клиентов, заказы и их состояния.

С чего начать

Провести первый заказ

Получите каталог, рассчитайте корзину, авторизуйте клиента, создайте заказ и проверьте оплату.

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

Подключить действующий магазин

Передавайте товары, цены и остатки из своей системы, а затем получайте созданные заказы.

Синхронизация магазина

Настроить приложение

Создайте Application, получите App Token, привяжите склад и подключите вебхук об оплате.

Настройка приложения

Как проходит покупка

  1. Сайт получает каталог по App Token.
  2. Gigma рассчитывает корзину и проверяет остатки.
  3. Клиент входит и получает Counterparty Bearer.
  4. Сайт создаёт заказ.
  5. Если нужна онлайн-оплата, сайт открывает payment_link.
  6. После оплаты сайт повторно получает заказ или обрабатывает вебхук order.paid.

Готовые запросы и ответы приведены в быстром старте.

Подготовка магазина

Перед первым заказом подготовьте:

  • бизнес и реквизиты;
  • стратегию продаж;
  • Application и App Token;
  • склад с платёжной интеграцией;
  • товар, цену и положительный остаток;
  • способы доставки и оплаты.

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

Контентный сайт может работать без склада. Для каталога с заказами и оплатой склад обязателен.

Выберите задачу

Чтобы создать приложение и получить App Token, откройте настройку приложения.

Чтобы провести первый заказ, откройте быстрый старт.

Чтобы передавать товары и остатки из своей системы, откройте синхронизацию магазина.

Чтобы получить товары для витрины, откройте каталог и цены.

Чтобы рассчитать корзину, создать заказ и проверить оплату, откройте заказы и оплату.

Чтобы получить способы доставки, оплаты и значения фильтров, откройте доставку, оплату и справочники.

Чтобы подключить скидку по коду, откройте промокоды.

Чтобы загрузить изображения и документы, откройте файлы и медиа.

Какие токены понадобятся

  • App Token определяет приложение и передаётся в запросах каталога, корзины и справочников.
  • Counterparty Bearer представляет клиента и нужен для заказов, профиля и избранного.
  • Bearer сотрудника используется на вашем сервере для настройки приложения, товаров, складов и промокодов.

Точный набор заголовков указан в карточке каждого метода. App Token не подтверждает личность клиента и не заменяет Counterparty Bearer.

После создания заказа

Возврат клиента с платёжной страницы не подтверждает оплату. После возврата снова получите заказ через GET /api/counterparty/orders/{id} или обработайте вебхук order.paid, а затем сверьте заказ через API.

Если результат POST неизвестен из-за timeout, сетевой ошибки или 5xx, сначала проверьте список заказов. Не повторяйте создание, пока не убедитесь, что первый запрос не был выполнен.

Другие сценарии

Для регулярных списаний и платного доступа используйте сервис управления подписками. Для страниц, блоков и меню используйте CMS.