Gigma

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

С помощью этой статьи вы получите каталог, создадите первый заказ и проверите его оплату.

Подготовка

Перед началом:

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

В примерах <application_token> — App Token, а <counterparty_token> — Bearer клиента, который Gigma вернёт после входа.

Шаг 1. Получите каталог

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

В ответ вы получите товары текущего Application. Сохраните products.data[].id: он понадобится для расчёта корзины и создания заказа.

Фильтры, сортировка и поля карточки описаны в разделе «Каталог и цены».

Шаг 2. Рассчитайте корзину

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

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

В ответе используйте final_price как итоговую сумму. Метод также проверит доступный остаток и правила упаковки до создания заказа.

Полное описание — в карточке предварительного расчёта.

Шаг 3. Авторизуйте клиента

Сначала запросите одноразовый код:

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

{ "phone": "79999999999" }

Затем обменяйте код на Counterparty Bearer:

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

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

Сохраните Bearer из ответа и передавайте его в Authorization при работе с заказами клиента.

Другие способы входа и ошибки описаны в разделе «Вход клиента».

Шаг 4. Создайте заказ

Идентификаторы ниже приведены только для примера. Передавайте значения, полученные из справочников вашего Application.

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

{
	"delivery_type_id": 1,
	"shop_id": 12,
	"payment_type_id": 2,
	"products": [
		{ "id": 34786, "quantity": 2 }
	]
}

В ответе вы получите объект order. Сохраните order.id. Для платного заказа также придёт payment_link.

Состав тела зависит от выбранного способа доставки. Полный контракт — в разделе «Создать заказ».

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

Шаг 5. Отправьте клиента на оплату

Перенаправьте клиента по order.payment_link.

Возврат с платёжной страницы означает только завершение пользовательского сценария. Он не подтверждает, что платёж успешно обработан.

Шаг 6. Проверьте заказ

GET /api/counterparty/orders/{id} HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Authorization: Bearer <counterparty_token>
Accept: application/json

Сравните order.id с запрошенным значением и покажите пользователю состояние из order.status.

Для серверной автоматизации дополнительно подключите вебхук order.paid. После вебхука снова получите заказ через API, прежде чем выдавать товар или доступ.

Готово

Вы получили каталог, создали заказ и подтвердили его состояние запросом к Gigma.

Дальнейшие шаги