gamification.shop.product.order

Scope: gamification

Кто может вызывать: Любой авторизованный пользователь. Подробнее: Права доступа

Оформить заказ на товар из магазина бонусов: списать BAL, создать запись заказа, отправить уведомления.

HTTP: POST

Побочные эффекты: списывает BAL у пользователя, уменьшает доступный остаток товара, создаёт запись заказа, запускает бизнес-процесс (если настроен), отправляет уведомления.

Параметры метода

Параметр Тип Обяз. Описание
id int да ID товара (псевдоним: productId)
siteId string нет ID сайта (псевдоним: SITE_ID). По умолчанию — текущий сайт или s1

Возвращаемые данные

result.result — объект созданного заказа.

Обработка ошибок

Справочник кодов ошибок.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Не передан id
NOT_FOUND Товар не найден
OUT_OF_STOCK Товар недоступен для заказа (нет запаса или продажи отключены)
INSUFFICIENT_BALANCE Недостаточно BAL

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/gamification.shop.product.order.json" \
          -H "Content-Type: application/json" \
          -d '{"id": 1}'
        

Пример ответа:

{
          "result": {
            "result": {
              "ID": "201",
              "PRODUCT_ID": "1",
              "USER_ID": "42",
              "STATUS": "new",
              "DATE_CREATE": "2026-08-20T11:00:00+03:00"
            },
            "total": null,
            "next": null,
            "error": null
          }
        }