Gigma

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

Пять запросов от каталога до оплаченного заказа. Что должно быть настроено до первого вызова — в обзоре.

Ниже <application_token> — App Token приложения, <counterparty_token> — Bearer клиента после входа.

1. Каталог

GET /api/counterparty/products HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Возвращает товары складов этого приложения с ценами и наличием. Фильтры, поиск и сортировка — на странице каталога.

2. Расчёт корзины

POST /api/counterparty/orders/precalculate HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Content-Type: application/json

{ "products": [{ "id": 34786, "quantity": 2 }] }

Считает стоимость и проверяет наличие до создания заказа: клиент увидит итог и не упрётся в отказ на последнем шаге. Вход здесь ещё не нужен. Контракт — расчёт заказа.

3. Вход клиента

POST /api/counterparty/send_password HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Content-Type: application/json

{ "phone": "79999999999" }

Клиент получает одноразовый код звонком, затем обменивает его на Bearer:

POST /api/counterparty/login HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Content-Type: application/json

{ "phone": "79999999999", "password": "1234", "device": "web" }

Клиент создаётся автоматически, отдельной регистрации нет. Другие способы входа — miniapp и подтверждение звонка — на странице входа клиента.

4. Заказ

POST /api/counterparty/orders HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Authorization: Bearer <counterparty_token>
Content-Type: application/json

С этого шага нужны оба токена: App Token — какое приложение, Bearer — какой клиент. Состав тела с доставкой, оплатой и адресом — в создании заказа.

5. Оплата

Ответ на создание заказа содержит payment_link, если заказ платный. Перенаправьте клиента по этой ссылке.

Дальше важное правило: возврат клиента с платёжной страницы не означает оплату. Состояние заказа берите ответом Gigma — заказ по идентификатору, — а если у вас есть свой сервер, подпишитесь на webhook об оплате.

Что дальше

© 2026 Gigma