Интернет-магазин

Товары, остатки и заказы хранятся в Gigma — своя база магазина не нужна. Договора с платёжным провайдером и интеграции с ним тоже не нужно: заказ создаётся запросом, а ссылка на оплату приходит в ответе. Корзину считает orders/precalculate.

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

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

Клиент                Ваш сайт              Gigma                 Банк
  │  выбирает товар      │                    │                     │
  │─────────────────────>│  каталог, цены     │                     │
  │                      │───────────────────>│                     │
  │  оформляет заказ     │  расчёт корзины    │                     │
  │─────────────────────>│───────────────────>│                     │
  │                      │  создание заказа   │                     │
  │                      │───────────────────>│  создаёт платёж     │
  │                      │<── payment_link ───│────────────────────>│
  │  платит по ссылке    │                    │                     │
  │──────────────────────┼────────────────────┼────────────────────>│
  │                      │  статус заказа     │<── подтверждение ───│
  │                      │<──────────────────>│                     │

Заказ создаётся до оплаты и живёт своей жизнью: платёж может пройти, отвалиться или зависнуть, поэтому состояние всегда берётся из Gigma, а не из того, куда вернулся браузер.

Что нужно для старта

App Token — заголовок Token, выдаётся при создании приложения.
Склад — привязывается обновлением приложения. Без склада каталог пуст, а расчёт заказа отвечает 422.
Категории и бренды — добавляются приложению, клиентские справочники возвращают только их.
Counterparty Bearer — нужен с шага создания заказа, выдаётся при входе клиента.

Сценарии

Задача	Метод	Контракт
Каталог	`GET /api/counterparty/products`	товары
Карточка товара	`GET /api/counterparty/products/{id}`	товар
Расчёт корзины	`POST /api/counterparty/orders/precalculate`	расчёт
Создание заказа	`POST /api/counterparty/orders`	заказ
Проверка оплаты	`GET /api/counterparty/orders/{id}`	статус заказа
История заказов	`GET /api/counterparty/orders`	список
Заказ без входа клиента	`POST /api/counterparty/contact_form`	контактная форма
Доставка и оплата	`GET /api/counterparty/delivery_types`, `/payment_types`	справочники
Оповещение вашего backend	webhook `order.paid`	вебхуки

Сквозной путь от каталога до оплаты — быстрый старт.

Что учесть

Оплату подтверждает GET /api/counterparty/orders/{id} или webhook order.paid. Возврат клиента с платёжной страницы не подтверждает ничего.
При wholesale: true количество в заказе должно быть кратно упаковке, иначе 422.
Идентификаторы доставки, оплаты и магазинов берите из справочников, а не из примеров.

Регулярные платежи за доступ — в разделе «Сервис управления подписками».

Ограничения

Маркетплейс со сплит-платежами, сложная логистика, бухгалтерия и офлайн-касса в API не поддержаны. Интерфейс пишете вы: платформа отдаёт данные и принимает заказы, но не рисует экраны.