openapi: 3.0.0
info:
  description: >-
    # Введение


    Digital Distribution Hub — новое решение Иксоллы, которое соединяет
    электронные и физические платежи через технологию push-платежей и
    e-commerce.


    Данная документация включает в себя описание методов API для продуктов
    [Внутриигровой магазин](https://developers.xsolla.com/ru/doc/in-game-store/)
    и [Платежи](https://developers.xsolla.com/ru/doc/pay-station/). Используется
    два базовых URL-адреса:


    * `https://store.xsolla.com/api` для групп **Общие**, **Каталог**,
    **Корзина** и **Заказ**.

    * `https://ps.xsolla.com` для группы **Уведомления**.


    Использование методов API из группы **Каталог** не требует авторизации. 


    Чтобы использовать методы API из групп **Корзина** и **Заказ**, вам
    необходимо [создать
    токен](https://developers.xsolla.com/ru/digital-distribution-hub/common/user-token/create-user-token).


    <div class='note'><b>Примечание</b><br><br>Данная документация не является
    полностью функциональным интерфейсом и представляет собой дизайн будущего
    API. В настоящее время вы можете использовать только методы из групп
    <b>Каталог</b> и <b>Уведомления</b>. Если вы хотите поделиться обратной
    связью, отправьте нам письмо по адресу <a
    href="mailto:techdoc@xsolla.com">techdoc@xsolla.com</a>.</div>
  title: Digital Distribution Hub
  version: 1.0.0
servers:
  - url: https://store.xsolla.com/api
tags:
  - name: cart
    x-displayName: Корзина
  - name: game keys
    x-displayName: Игровые ключи
  - name: virtual items & currency
    x-displayName: Виртуальные предметы и валюта
  - name: bundles
    x-displayName: Бандлы
  - name: user token
    x-displayName: Токен пользователя
  - name: notifications
    x-displayName: Уведомления
  - name: order
    x-displayName: Заказ
paths:
  /push-payments/cancel:
    post:
      description: |-
        Отправьте уведомление об отмене платежа в следующих случаях:
         - платеж не был выполнен;
         - был оформлен возврат платежа.
      operationId: cancel-notification
      requestBody:
        content:
          application/json:
            example:
              payment_id: 784998479
            schema:
              properties:
                payment_id:
                  type: integer
              required:
                - payment_id
              type: object
      responses:
        '200':
          description: OK.
        '400':
          description: Bad request.
        '403':
          description: Доступ запрещен.
        '404':
          description: Платеж не найден.
        '409':
          description: Платеж уже отменен.
        '422':
          description: Ошибка при отмене платежа.
        '500':
          description: Внутренняя ошибка сервера.
      servers:
        - url: https://ps.xsolla.com
      summary: Уведомление об отмене
      tags:
        - notifications
  /push-payments/pay:
    post:
      description: Отправьте это уведомление после успешного списания средств пользователя.
      operationId: pay-notification
      requestBody:
        content:
          application/json:
            example:
              payment:
                amount: 10
                currency: USD
                geotype_id: 13038
                ps_transaction_id: ps_transaction_id
              project_id: 18404
              purchase:
                order_id: 1334430
              user:
                id: s.ivanov
            schema:
              properties:
                payment:
                  properties:
                    amount:
                      description: Сумма платежа.
                      type: number
                    currency:
                      description: >-
                        Валюта платежа. Используется трехбуквенное обозначение
                        валюты согласно стандарту [ISO
                        4217](https://en.wikipedia.org/wiki/ISO_4217).
                      type: string
                    geotype_id:
                      description: Идентификатор партнера-дистрибьютора на стороне Иксоллы.
                      type: integer
                    project_transaction_id:
                      description: Идентификатор транзакции на стороне разработчика игры.
                      type: string
                    ps_transaction_id:
                      description: >-
                        Идентификатор транзакции на стороне
                        партнера-дистрибьютора.
                      type: string
                  required:
                    - geotype_id
                    - amount
                  type: object
                project_id:
                  description: ID проекта.
                  type: integer
                purchase:
                  properties:
                    order_id:
                      description: Идентификатор заказа.
                      type: integer
                  required:
                    - order_id
                  type: object
                user:
                  properties:
                    email:
                      description: Email-адрес пользователя.
                      type: string
                    id:
                      description: Уникальный идентификатор пользователя в игре.
                      type: string
                    phone:
                      description: Номер телефона пользователя.
                      type: string
                    ps_account_id:
                      description: >-
                        Идентификатор платежного аккаунта пользователя на
                        стороне партнера-дистрибьютора.
                      type: string
                  required:
                    - id
                  type: object
              required:
                - project_id
                - payment
                - purchase
                - user
              type: object
      responses:
        '200':
          content:
            application/json:
              example:
                payment_id: 784998484
              schema:
                properties:
                  payment_id:
                    type: integer
                type: object
          description: OK.
        '400':
          description: Bad request.
        '403':
          description: Доступ запрещен.
        '404':
          description: Заказ не найден.
        '409':
          description: Заказ уже оплачен.
        '422':
          description: Ошибка при создании платежа.
        '500':
          description: Внутренняя ошибка сервера.
      servers:
        - url: https://ps.xsolla.com
      summary: Уведомление об оплате
      tags:
        - notifications
  /v2/project/{project_id}/cart:
    get:
      description: Возвращает корзину текущего пользователя.
      operationId: get-user-cart
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    cart_id: cart_id
                    is_free: false
                    items:
                      - attributes: []
                        description: >-
                          Take it, take it all! All of Xsollas riches in one
                          Mega Booster.
                        groups:
                          - external_id: powerups
                            name: Power Ups
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: Xsolla Booster Mega
                        price:
                          amount: '50.0000000000000000'
                          amount_without_discount: '100.0000000000000000'
                          currency: USD
                        quantity: 123
                        sku: booster_mega_1
                        type: virtual_good
                        virtual_item_type: consumable
                        virtual_prices: []
                    price:
                      amount: '6150.0000000000000000'
                      amount_without_discount: '6150.0000000000000000'
                      currency: USD
              schema:
                $ref: '#/components/schemas/Cart_inline_response_200'
          description: Корзина с предметами успешно возвращена.
      security:
        - AuthForClient: []
      summary: Получение корзины текущего пользователя
      tags:
        - cart
  /v2/project/{project_id}/cart/clear:
    put:
      description: Удаляет все предметы из корзины.
      operationId: cart-clear
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      responses:
        '204':
          description: Корзина успешно очищена.
      security:
        - AuthForClient: []
      summary: Удаление всех предметов из текущей корзины
      tags:
        - cart
  /v2/project/{project_id}/cart/fill:
    put:
      description: >-
        Наполняет корзину предметами. Если в корзине уже есть предмет с таким же
        артикулом, существующий предмет будет заменен.
      operationId: cart-fill
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/fill-cart-json-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    cart_id: cart_id
                    is_free: false
                    items:
                      - attributes: []
                        description: >-
                          Take it, take it all! All of Xsollas riches in one
                          Mega Booster.
                        groups:
                          - external_id: powerups
                            name: Power Ups
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: Xsolla Booster Mega
                        price:
                          amount: '50.0000000000000000'
                          amount_without_discount: '100.0000000000000000'
                          currency: USD
                        quantity: 123
                        sku: booster_mega_1
                        type: virtual_good
                        virtual_item_type: consumable
                        virtual_prices: []
                    price:
                      amount: '6150.0000000000000000'
                      amount_without_discount: '6150.0000000000000000'
                      currency: USD
                    warnings:
                      - errorCode: 4001
                        errorMessage: >-
                          [0401-4001]: Item with Project Id = 44056 and Sku =
                          booster_mega_2 not found
                        quantity: 1
                        sku: booster_mega_21
              schema:
                $ref: '#/components/schemas/Cart_inline_response_200_1'
          description: Корзина с предметами успешно возвращена.
      security:
        - AuthForClient: []
      summary: Наполнение корзины предметами
      tags:
        - cart
  /v2/project/{project_id}/cart/item/{item_sku}:
    delete:
      description: Удаляет предмет из корзины.
      operationId: delete-item
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
      responses:
        '204':
          description: Предмет из корзины успешно удален.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cart_inline_response_404'
          description: >-
            Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны
            верно.
      security:
        - AuthForClient: []
      summary: Удаление предмета из текущей корзины
      tags:
        - cart
    put:
      description: Обновляет существующий или создает новый предмет в корзине.
      operationId: put-item
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/put-item-by-cart-id-json-model'
      responses:
        '204':
          description: Корзина успешно обновлена.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cart_inline_response_404'
          description: >-
            Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны
            верно.
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1421
                    errorMessage: Only Virtual Good Supported
                    statusCode: 422
              schema:
                $ref: '#/components/schemas/Cart_inline_response_422_1'
          description: Этот тип предмета нельзя добавить в корзину. Выберите другой тип.
      security:
        - basicAuth: []
      summary: Обновление предмета из текущей корзины
      tags:
        - cart
  /v2/project/{project_id}/cart/{cart_id}:
    get:
      description: Возвращает корзину пользователя по идентификатору корзины.
      operationId: get-cart-by-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    cart_id: cart_id
                    is_free: false
                    items:
                      - attributes: []
                        description: >-
                          Take it, take it all! All of Xsollas riches in one
                          Mega Booster.
                        groups:
                          - external_id: powerups
                            name: Power Ups
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: Xsolla Booster Mega
                        price:
                          amount: '50.0000000000000000'
                          amount_without_discount: '100.0000000000000000'
                          currency: USD
                        quantity: 123
                        sku: booster_mega_1
                        type: virtual_good
                        virtual_item_type: consumable
                        virtual_prices: []
                    price:
                      amount: '6150.0000000000000000'
                      amount_without_discount: '6150.0000000000000000'
                      currency: USD
              schema:
                $ref: '#/components/schemas/Cart_inline_response_200'
          description: Корзина с предметами успешно возвращена.
      security:
        - AuthForClient: []
      summary: Получение корзины по идентификатору корзины
      tags:
        - cart
  /v2/project/{project_id}/cart/{cart_id}/clear:
    put:
      description: Удаляет все предметы из корзины.
      operationId: cart-clear-by-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
      responses:
        '204':
          description: Корзина успешно очищена.
      security:
        - AuthForClient: []
      summary: Удаление всех предметов из корзины по ID корзины
      tags:
        - cart
  /v2/project/{project_id}/cart/{cart_id}/fill:
    put:
      description: >-
        Наполняет определенную корзину предметами. Если в корзине уже есть
        предмет с таким же артикулом, существующий предмет будет заменен.
      operationId: cart-fill-by-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/fill-cart-json-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    cart_id: cart_id
                    is_free: false
                    items:
                      - attributes: []
                        description: >-
                          Take it, take it all! All of Xsollas riches in one
                          Mega Booster.
                        groups:
                          - external_id: powerups
                            name: Power Ups
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: Xsolla Booster Mega
                        price:
                          amount: '50.0000000000000000'
                          amount_without_discount: '100.0000000000000000'
                          currency: USD
                        quantity: 123
                        sku: booster_mega_1
                        type: virtual_good
                        virtual_item_type: consumable
                        virtual_prices: []
                    price:
                      amount: '6150.0000000000000000'
                      amount_without_discount: '6150.0000000000000000'
                      currency: USD
                    warnings:
                      - errorCode: 4001
                        errorMessage: >-
                          [0401-4001]: Item with Project Id = 44056 and Sku =
                          booster_mega_2 not found
                        quantity: 1
                        sku: booster_mega_21
              schema:
                $ref: '#/components/schemas/Cart_inline_response_200_1'
          description: Корзина с предметами успешно возвращена.
      security:
        - AuthForClient: []
      summary: Наполнение определенной корзины предметами
      tags:
        - cart
  /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}:
    delete:
      description: Удаляет предмет из корзины.
      operationId: delete-item-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
      responses:
        '204':
          description: Предмет из корзины успешно удален.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cart_inline_response_404'
          description: >-
            Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны
            верно.
      security:
        - AuthForClient: []
      summary: Удаление предмета из корзины по ID корзины
      tags:
        - cart
    put:
      description: Обновляет существующий или создает новый предмет в корзине.
      operationId: put-item-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/put-item-by-cart-id-json-model'
      responses:
        '204':
          description: Корзина успешно обновлена.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cart_inline_response_404'
          description: >-
            Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны
            верно.
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1102
                    errorMessage: '[0401-1102]: Item quantity must be non-negative integer'
                    statusCode: 422
              schema:
                $ref: '#/components/schemas/Cart_inline_response_422'
          description: Количество предметов не должно быть отрицательным числом.
      security:
        - basicAuth: []
      summary: Обновление предмета в корзине по ID корзины
      tags:
        - cart
  /v2/project/{project_id}/distribution_hub/order/{order_id}:
    get:
      description: Получение указанного заказа.
      operationId: get-order
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/order-id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    content:
                      is_free: 'false'
                      items:
                        - is_free: false
                          price:
                            amount: '30'
                            amount_without_discount: '30'
                            currency: USD
                          quantity: 1
                          sku: some_sku
                      price:
                        amount: '30'
                        amount_without_discount: '30'
                        currency: USD
                    order_id: 1
                    status: paid
              schema:
                $ref: '#/components/schemas/Order_inline_response_200_1'
          description: Успешный запрос данных о заказе.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 9001
                    errorMessage: '[0401-9001]: Order not found'
                    statusCode: 404
              schema:
                $ref: '#/components/schemas/Order_inline_response_404'
          description: >-
            Заказ не найден. Убедитесь, что `project_id` и `order_id` указаны
            верно.
      security:
        - AuthForClient: []
      summary: Получение заказа
      tags:
        - order
  /v2/project/{project_id}/distribution_hub/payment/cart:
    post:
      description: >-
        Создание заказа со всеми предметами из корзины. Созданному заказу
        присваивается статус `new`.
      operationId: create-order
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-order-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    billing_info:
                      direct_taxes:
                        - amount: 150
                          name: TAX
                          rate: 10
                      indirect_taxes:
                        - amount: 246.75
                          name: VAT
                          rate: 20
                      price:
                        amount: 1480.45
                        currency: USD
                    order_id: 641
              schema:
                $ref: '#/components/schemas/Order_inline_response_200'
          description: Заказ успешно создан.
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1401
                    errorMessage: '[0401-1401]: Invalid cart'
                    statusCode: 422
              schema:
                $ref: '#/components/schemas/Order_inline_response_422'
          description: >-
            Недействительная корзина. Убедитесь, что корзина существует, она не
            пустая, и в ней отсутствуют бесплатные предметы.
      security:
        - AuthForClient: []
      summary: Создание заказа со всеми предметами из текущей корзины
      tags:
        - order
  /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}:
    post:
      description: >-
        Создание заказа со всеми предметами из указанной корзины. Созданному
        заказу присваивается статус `new`.
      operationId: create-order-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/cart-id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-order-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    billing_info:
                      direct_taxes:
                        - amount: 150
                          name: TAX
                          rate: 10
                      indirect_taxes:
                        - amount: 246.75
                          name: VAT
                          rate: 20
                      price:
                        amount: 1480.45
                        currency: USD
                    order_id: 641
              schema:
                $ref: '#/components/schemas/Order_inline_response_200'
          description: Заказ успешно создан.
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1401
                    errorMessage: '[0401-1401]: Invalid cart'
                    statusCode: 422
              schema:
                $ref: '#/components/schemas/Order_inline_response_422'
          description: >-
            Недействительная корзина. Убедитесь, что корзина существует, она не
            пустая, и в ней отсутствуют бесплатные предметы.
      security:
        - AuthForClient: []
      summary: Создание заказа со всеми предметами из определенной корзины
      tags:
        - order
  /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}:
    post:
      description: >-
        Создание заказа с указанным предметом. Созданному заказу присваивается
        статус `new`.
      operationId: create-order-with-item
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-order-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    billing_info:
                      direct_taxes:
                        - amount: 150
                          name: TAX
                          rate: 10
                      indirect_taxes:
                        - amount: 246.75
                          name: VAT
                          rate: 20
                      price:
                        amount: 1480.45
                        currency: USD
                    order_id: 641
              schema:
                $ref: '#/components/schemas/Order_inline_response_200'
          description: Заказ успешно создан.
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1411
                    errorMessage: '[0401-1411]: Invalid item'
                    statusCode: 422
              schema:
                $ref: '#/components/schemas/Order_inline_response_422_1'
          description: >-
            Недействительный предмет. Убедитесь, что предмет существует, он не
            выключен, не удален и не является бесплатным.
      security:
        - AuthForClient: []
      summary: Создание заказа с указанным предметом
      tags:
        - order
  /v2/project/{project_id}/distribution_hub/user/auth:
    post:
      description: >-
        Проверяет существование пользователя в игре и создает токен с его
        данными.
      operationId: create-user-token
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/post-user-token-json-model'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    token: >-
                      eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
              schema:
                $ref: '#/components/schemas/Common_inline_response_200_1'
          description: Токен пользователя успешно получен.
      security:
        - basicAuth: []
      summary: Создание токена пользователя
      tags:
        - user token
  /v2/project/{project_id}/items/bundle:
    get:
      description: >-
        Получение списка бандлов для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>.</div>
      operationId: get-bundle-list
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  $ref: '#/components/examples/200-get-bundle-list'
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_10'
          description: Список бандлов успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка бандлов
      tags:
        - bundles
  /v2/project/{project_id}/items/bundle/sku/{sku}:
    get:
      description: Получение указанного бандла.
      operationId: get-bundle
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  $ref: '#/components/examples/200-get-bundle'
              schema:
                $ref: '#/components/schemas/Catalog_client_bundle'
          description: Указанный бандл успешно получен.
      security:
        - AuthForClient: []
      summary: Получение указанного бандла
      tags:
        - bundles
  /v2/project/{project_id}/items/game:
    get:
      description: >-
        Получение списка игр для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-games-list
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          $ref: >-
                            #/components/examples/client-attribute-game/Catalog_value
                        description: Game description
                        groups:
                          - external_id: all
                            name: All games
                          - external_id: Xsolla
                            name: Xsolla games
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: game_1
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam
                            has_keys: true
                            is_free: false
                            is_pre_order: true
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            release_date: '2020-08-11T10:00:00+03:00'
                            sku: game_key_01
                            type: game_key
                            virtual_prices: []
                          - drm_name: Origin
                            drm_sku: origin
                            has_keys: false
                            is_free: false
                            is_pre_order: false
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            sku: game_key_02
                            type: game_key
                            virtual_prices: []
                        unit_type: game
                      - attributes:
                          - external_id: OS
                            name: OS
                            values:
                              - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                                value: Windows
                        description: Game description
                        groups:
                          - external_id: all
                            name: All games
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: game_2
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam
                            has_keys: false
                            is_free: false
                            is_pre_order: false
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            sku: game_key_01
                            type: game_key
                            virtual_prices: []
                        unit_type: game
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200'
          description: Список игр успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка игр
      tags:
        - game keys
  /v2/project/{project_id}/items/game/drm:
    get:
      description: Получение списка доступных DRM.
      operationId: get-drm-list
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    drm:
                      - drm_id: 1
                        image: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        link: https://support.steampowered.com
                        name: Steam
                        redeem_instruction_link: https://support.steampowered.com
                        sku: steam
                      - drm_id: 2
                        image: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Playstation
                        redeem_instruction_link: https://support.us.playstation.com
                        sku: playstation
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_4'
          description: Список DRM успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка DRM
      tags:
        - game keys
  /v2/project/{project_id}/items/game/group/{external_id}:
    get:
      description: >-
        Получение списка игр из указанной группы для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-games-group
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/external-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          $ref: >-
                            #/components/examples/client-attribute-game/Catalog_value
                        description: Game description
                        groups:
                          - external_id: all
                            name: All games
                          - external_id: Xsolla
                            name: Xsolla games
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: game_1
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam
                            has_keys: true
                            is_free: false
                            is_pre_order: true
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            release_date: '2020-08-11T10:00:00+03:00'
                            sku: game_key_01
                            type: game_key
                            virtual_prices: []
                          - drm_name: Origin
                            drm_sku: origin
                            has_keys: false
                            is_free: false
                            is_pre_order: false
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            sku: game_key_02
                            type: game_key
                            virtual_prices: []
                        unit_type: game
                      - attributes:
                          - external_id: OS
                            name: OS
                            values:
                              - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                                value: Windows
                        description: Game description
                        groups:
                          - external_id: all
                            name: All games
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: game_2
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam
                            has_keys: false
                            is_free: false
                            is_pre_order: false
                            price:
                              amount: '30.5'
                              amount_without_discount: '30.5'
                              currency: USD
                            sku: game_key_01
                            type: game_key
                            virtual_prices: []
                        unit_type: game
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200'
          description: Список игр успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка игр для указанной группы
      tags:
        - game keys
  /v2/project/{project_id}/items/game/key/group/{external_id}:
    get:
      description: >-
        Получение списка игр из указанной группы с привязкой к платформе для
        построения каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-game-keys-group
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/external-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          $ref: >-
                            #/components/examples/client-attribute-game-horror/Catalog_value
                        description: Game description
                        drm_name: Steam
                        drm_sku: steam
                        groups:
                          - external_id: all
                            name: All games
                          - external_id: Xsolla
                            name: Xsolla games
                        has_keys: true
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        is_free: false
                        is_pre_order: true
                        name: Game name
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        release_date: '2020-08-11T10:00:00+03:00'
                        sku: game_1
                        type: game_key
                        virtual_prices: []
                      - attributes:
                          $ref: >-
                            #/components/examples/client-attribute-game-horror/Catalog_value
                        description: Game description
                        drm_name: Steam
                        drm_sku: steam
                        groups:
                          - external_id: all
                            name: All games
                        has_keys: true
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        is_free: false
                        is_pre_order: false
                        name: Game name
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        sku: game_2
                        type: game_key
                        virtual_prices: []
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_3'
          description: Список игр успешно получен.
      security:
        - AuthForClient: []
      summary: Получение игр с привязкой к платформе для указанной группы
      tags:
        - game keys
  /v2/project/{project_id}/items/game/key/sku/{item_sku}:
    get:
      description: Получение игры на платформе для каталога.
      operationId: get-game-key-by-sku
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    attributes:
                      $ref: >-
                        #/components/examples/client-attribute-game-horror/Catalog_value
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: true
                    name: Game name
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    release_date: '2020-08-11T10:00:00+03:00'
                    sku: game_1
                    type: game_key
                    virtual_prices: []
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_2'
          description: Игра успешно получена.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_key_1'' not found'
                    statusCode: 404
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_404_1'
          description: Игра не найдена.
      security:
        - AuthForClient: []
      summary: Получение игры на платформе для каталога
      tags:
        - game keys
  /v2/project/{project_id}/items/game/sku/{item_sku}:
    get:
      description: Получение игры для каталога.
      operationId: get-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/item-sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    attributes:
                      $ref: >-
                        #/components/examples/client-attribute-game/Catalog_value
                    description: Game description
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    sku: game_1
                    type: unit
                    unit_items:
                      - drm_name: Steam
                        drm_sku: steam
                        has_keys: true
                        is_free: false
                        is_pre_order: true
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        release_date: '2020-08-11T10:00:00+03:00'
                        sku: game_key_01
                        type: game_key
                        virtual_prices: []
                      - drm_name: Origin
                        drm_sku: origin
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        sku: game_key_02
                        type: game_key
                        virtual_prices: []
                    unit_type: game
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_1'
          description: Игра успешно получена.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_404'
          description: Игра не найдена.
      security:
        - AuthForClient: []
      summary: Получение игры для каталога
      tags:
        - game keys
  /v2/project/{project_id}/items/groups:
    get:
      description: Получение списка групп предметов для создания каталога.
      operationId: get-item-groups
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    groups:
                      - children: []
                        description: Accessory
                        external_id: accessory
                        level: 0
                        name: Accessory
                        order: 1
                      - children: []
                        description: Background
                        external_id: background
                        level: 0
                        name: Background
                        order: 1
                      - children: []
                        description: Hair
                        external_id: hair
                        level: 0
                        name: Hair
                        order: 1
                      - children: []
                        description: Outfit
                        external_id: outfit
                        level: 0
                        name: Outfit
                        order: 1
                      - children: []
                        description: Body
                        external_id: body
                        level: 0
                        name: Body
                        order: 1
                      - children: []
                        description: Body
                        external_id: delete_group
                        level: 0
                        name: Body
                        order: 1
                      - children:
                          - children: []
                            description: Group description
                            external_id: test_group_secure
                            image_url: http://static.xsolla.com/img/xsolla-logo2.png
                            level: 1
                            name: Test group secure
                            order: 5
                            parent_external_id: very_cool_group
                        description: Very cool group
                        external_id: very_cool_group
                        level: 0
                        name: Very cool group
                        order: 1
                      - children:
                          - children: []
                            description: Group description
                            external_id: test_group_split
                            image_url: http://static.xsolla.com/img/xsolla-logo2.png
                            level: 1
                            name: Test group secure
                            order: 1
                            parent_external_id: test_group_secure
                        description: Group description
                        external_id: test_group_secure
                        image_url: http://static.xsolla.com/img/xsolla-logo2.png
                        level: 0
                        name: Test group secure
                        order: 1
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_9'
          description: Список групп успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка групп предметов
      tags:
        - virtual items & currency
  /v2/project/{project_id}/items/virtual_currency:
    get:
      description: >-
        Получение списка виртуальных валют для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                        description: Big Rocket - short description
                        groups:
                          - external_id: accessory
                            name: Accessory
                        image_url: >-
                          https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: Big Rocket
                        price:
                          amount: '100.99'
                          amount_without_discount: '100.99'
                          currency: USD
                        sku: big_rocket
                        type: virtual_currency
                        virtual_prices:
                          - amount: 100
                            amount_without_discount: 100
                            description: description
                            image_url: http://image.png
                            is_default: true
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: shotgun_raider
                            type: virtual_currency
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                          - external_id: rating
                            name: Rating
                            values:
                              - external_id: >-
                                  rating_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '3.9'
                        description: description
                        groups:
                          - external_id: hair
                            name: Hair
                        image_url: http://image.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        price:
                          amount: '101.0'
                          amount_without_discount: '101.0'
                          currency: USD
                        sku: shotgun_raider
                        type: virtual_currency
                        virtual_prices: []
                      - attributes: []
                        description: description
                        groups: []
                        image_url: http://image.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                        is_free: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: shotgun_raider_2
                        type: virtual_currency
                        virtual_prices: []
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_6'
          description: Список виртуальных валют успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка виртуальных валют
      tags:
        - virtual items & currency
  /v2/project/{project_id}/items/virtual_currency/package:
    get:
      description: >-
        Получение списка пакетов виртуальной валюты для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes: []
                        bundle_type: virtual_currency_package
                        content:
                          - description: Big Rocket - short description
                            image_url: >-
                              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                            inventory_options:
                              consumable:
                                usages_count: 1
                            name: Big Rocket
                            quantity: 100
                            sku: big_rocket
                            type: virtual_currency
                        description: VC Short Package Description
                        groups: []
                        image_url: http://vc_package_image.png
                        is_free: false
                        name: VC Name first package
                        price:
                          amount: '2.0000'
                          amount_without_discount: '2.0000'
                          currency: USD
                        sku: vc_package_1
                        type: bundle
                        virtual_prices: []
                      - attributes: []
                        bundle_type: virtual_currency_package
                        content:
                          - description: description
                            image_url: http://image.png
                            inventory_options:
                              consumable:
                                usages_count: 1
                            name: SHOTGUN FOR TRUE RAIDERS
                            quantity: 200
                            sku: shotgun_raider
                            type: virtual_currency
                        description: VC Short Package Description
                        groups: []
                        image_url: http://vc_package_image.png
                        is_free: false
                        name: VC Name third package
                        price:
                          amount: '4.0000'
                          amount_without_discount: '4.0000'
                          currency: USD
                        sku: vc_package_3
                        type: bundle
                        virtual_prices: []
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_7'
          description: Список пакетов виртуальной валюты успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка пакетов виртуальной валюты
      tags:
        - virtual items & currency
  /v2/project/{project_id}/items/virtual_items:
    get:
      description: >-
        Получение списка виртуальных предметов для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-virtual-items
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                        description: Big Rocket - description
                        groups:
                          - external_id: accessory
                            name: Accessory
                        image_url: >-
                          https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                          expiration_period:
                            type: day
                            value: 1
                        is_free: false
                        name: Big Rocket
                        price:
                          amount: '100.99'
                          amount_without_discount: '100.99'
                          currency: USD
                        sku: big_rocket
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                        virtual_prices:
                          - amount: 100
                            amount_without_discount: 100
                            description: description
                            image_url: http://image.png
                            is_default: true
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test
                            type: virtual_currency
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                          - external_id: rating
                            name: Rating
                            values:
                              - external_id: >-
                                  rating_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '3.9'
                        description: description
                        groups:
                          - external_id: hair
                            name: Hair
                        image_url: http://image.png
                        inventory_options:
                          - consumable:
                              - usages_count: 1
                          - expiration_period:
                              - type: day
                              - value: 1
                        is_free: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        price:
                          amount: '101.0'
                          amount_without_discount: '101.0'
                          currency: USD
                        sku: shotgun_raider
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                        virtual_prices:
                          - amount: 100
                            amount_without_discount: 100
                            description: description
                            image_url: http://image.png
                            is_default: true
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test
                            type: virtual_currency
                          - amount: 200
                            amount_without_discount: 200
                            description: description
                            image_url: http://image.png
                            is_default: false
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test_2
                            type: virtual_currency
                      - attributes: []
                        description: description
                        groups: []
                        image_url: http://image.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                          expiration_period:
                            type: day
                            value: 1
                        is_free: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: shotgun_raider_2
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                        virtual_prices: []
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_5'
          description: Список виртуальных предметов успешно получен.
      security:
        - AuthForClient: []
      summary: Получение списка виртуальных предметов
      tags:
        - virtual items & currency
  /v2/project/{project_id}/items/virtual_items/group/{external_id}:
    get:
      description: >-
        Получение списка предметов из указанной группы для создания каталога. 


        <div class="notice"><strong>Обратите внимание.</strong> Все проекты
        имеют ограничение на количество предметов, которые вы можете получить в
        ответе. По умолчанию (максимальное значение) — <strong>50 предметов в
        одном ответе</strong>. Чтобы получать больше данных постранично,
        используйте параметры <b>limit</b> и <b>offset</b>. </div>
      operationId: get-virtual-items-group
      parameters:
        - $ref: '#/components/parameters/project-id-path-param'
        - $ref: '#/components/parameters/external-id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional-fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                        description: Big Rocket - description
                        groups:
                          - external_id: accessory
                            name: Accessory
                        image_url: >-
                          https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                          expiration_period:
                            type: day
                            value: 1
                        is_free: false
                        name: Big Rocket
                        price:
                          amount: '100.99'
                          amount_without_discount: '100.99'
                          currency: USD
                        sku: big_rocket
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                        virtual_prices:
                          - amount: 100
                            amount_without_discount: 100
                            description: description
                            image_url: http://image.png
                            is_default: true
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test
                            type: virtual_currency
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '5'
                          - external_id: rating
                            name: Rating
                            values:
                              - external_id: >-
                                  rating_e3364991f92e751689a68b96598a5a5a84010b85
                                value: '3.9'
                        description: description
                        groups:
                          - external_id: accessory
                            name: Accessory
                        image_url: http://image.png
                        inventory_options:
                          consumable:
                            usages_count: 1
                          expiration_period:
                            type: day
                            value: 1
                        is_free: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        price:
                          amount: '101.0'
                          amount_without_discount: '101.0'
                          currency: USD
                        sku: shotgun_raider
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                        virtual_prices:
                          - amount: 100
                            amount_without_discount: 100
                            description: description
                            image_url: http://image.png
                            is_default: true
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test
                            type: virtual_currency
                          - amount: 200
                            amount_without_discount: 200
                            description: description
                            image_url: http://image.png
                            is_default: false
                            name: SHOTGUN FOR TRUE RAIDERS
                            sku: vc_test_2
                            type: virtual_currency
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_200_8'
          description: Список предметов из указанной группы успешно получен.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4403
                    errorMessage: '[0401-4403]: Item group not found'
                    statusCode: 404
              schema:
                $ref: '#/components/schemas/Catalog_inline_response_404_2'
          description: >-
            Группа не найдена. Убедитесь, что передан корректный `external_id`,
            группа не отключена и не удалена.
      security:
        - AuthForClient: []
      summary: Получение списка предметов из указанной группы
      tags:
        - virtual items & currency
components:
  securitySchemes:
    AuthForClient:
      description: >-
        Используйте метод [Создать токен
        пользователя](https://developers.xsolla.com\/ru/api/digital-distribution-hub/operation/create-user-token)
        для создания токена.
      scheme: bearer
      type: http
    basicAuth:
      description: >-
        API Иксоллы использует базовую HTTP-аутентификацию. Все запросы к API
        должны содержать заголовок `Authorization: Basic
        <your_authorization_basic_key>`, где `your_authorization_basic_key` —
        это пара `distribution_hub_id:api_key`, закодированная по стандарту
        Base64. 


        Обратитесь к аккаунт-менеджеру проекта, чтобы получить
        `distribution_hub_id` и `api_key`.
      scheme: basic
      type: http
  parameters:
    project-id-path-param:
      description: ID проекта.
      explode: false
      in: path
      name: project_id
      required: true
      schema:
        example: 44056
        type: integer
      style: simple
    currency-query-param:
      description: >-
        Валюта, в которой отображаются цены (по умолчанию — USD). Используется
        трехбуквенное обозначение валюты согласно стандарту [ISO
        4217](https://en.wikipedia.org/wiki/ISO_4217).
      explode: true
      in: query
      name: currency
      required: false
      schema:
        default: USD
        type: string
      style: form
    locale-query-param:
      description: >-
        Язык ответа. Используется двухбуквенное обозначение языка согласно
        стандарту ISO 639-1.
      explode: true
      in: query
      name: locale
      required: false
      schema:
        default: en
        type: string
      style: form
    item-sku-path-param:
      description: Артикул предмета.
      explode: false
      in: path
      name: item_sku
      required: true
      schema:
        example: booster_mega_1
        type: string
      style: simple
    cart-id-path-param:
      description: ID корзины.
      explode: false
      in: path
      name: cart_id
      required: true
      schema:
        example: custom_id
        type: string
      style: simple
    order-id-path-param:
      description: Идентификатор заказа.
      explode: false
      in: path
      name: order_id
      required: true
      schema:
        example: '656'
        type: string
      style: simple
    limit-query-param:
      description: Лимит количества элементов на странице.
      example: 50
      explode: true
      in: query
      name: limit
      required: false
      schema:
        example: 50
        type: integer
      style: form
    offset-query-param:
      description: >-
        Номер элемента, с которого выполняется вывод на странице (нумерация
        ведется с 0).
      example: 0
      explode: true
      in: query
      name: offset
      required: false
      schema:
        example: 0
        type: integer
      style: form
    additional-fields-query-param:
      description: >-
        Список дополнительных полей. Эти поля будут в ответе, если вы отправите
        их в запросе. Доступные поля: `media_list`, `order`, `long_description`.
      explode: true
      in: query
      name: additional_fields[]
      required: false
      schema:
        items:
          type: string
        type: array
      style: form
    country-query-param:
      description: >-
        Страна для расчета региональных цен и ограничений для каталога.
        Используется двухбуквенное обозначение страны в верхнем регистре
        согласно стандарту [ISO 3166-1
        alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Если вы не
        укажете страну, она будет рассчитана на основе IP-адреса пользователя.
      explode: true
      in: query
      name: country
      required: false
      schema:
        default: US
        type: string
      style: form
    sku-path-param:
      description: Артикул бандла.
      explode: false
      in: path
      name: sku
      required: true
      schema:
        example: kg_1
        type: string
      style: simple
    external-id-path-param:
      description: Внешний идентификатор группы.
      explode: false
      in: path
      name: external_id
      required: true
      schema:
        default: all
        type: string
      style: simple
  schemas:
    Cart_admin-attribute-external_id:
      description: >-
        Уникальный идентификатор атрибута. `external_id` может содержать только
        строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
      example: attribute_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9-_]+$
      type: string
    Cart_value-external_id:
      description: >-
        Уникальный идентификатор атрибута. `external_id` может содержать только
        строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
      example: attribute_value
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
    Cart_clientattributes_inner:
      properties:
        external_id:
          $ref: '#/components/schemas/Cart_admin-attribute-external_id'
        name:
          description: Название атрибута.
          example: Genre
          type: string
        values:
          items:
            properties:
              external_id:
                $ref: '#/components/schemas/Cart_value-external_id'
              value:
                description: Значение атрибута.
                example: Strategy
                type: string
            type: object
          type: array
      type: object
    Cart_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих предмету. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        $ref: '#/components/schemas/Cart_clientattributes_inner'
      type: array
    Cart_inline_response_200_groups:
      properties:
        external_id:
          type: string
        name:
          type: string
      type: object
    Cart_inline_response_200_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Cart_client-attributes'
        description:
          type: string
        groups:
          items:
            $ref: '#/components/schemas/Cart_inline_response_200_groups'
          type: array
        image_url:
          type: string
        is_free:
          type: boolean
        name:
          nullable: true
          type: string
        quantity:
          type: integer
        sku:
          type: string
        type:
          type: string
      type: object
    Cart_inline_response_200_price:
      description: Стоимость корзины.
      example: >-
        {"amount":"6150.0000000000000000","amount_without_discount":"6150.0000000000000000","currency":"USD"}
      nullable: true
      properties:
        amount:
          default: '50.0000000000000000'
          type: string
        amount_without_discount:
          default: '100.0000000000000000'
          type: string
        currency:
          default: USD
          type: string
      type: object
    Cart_inline_response_200:
      properties:
        cart_id:
          description: ID корзины.
          example: cart_id
          type: string
        is_free:
          description: Если передано значение `true`, корзина бесплатная.
          type: boolean
        items:
          example:
            - attributes: []
              description: Take it, take it all! All of Xsollas riches in one Mega Booster.
              groups:
                - external_id: powerups
                  name: Power Ups
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
              inventory_options:
                consumable:
                  usages_count: 1
              is_free: false
              name: Xsolla Booster Mega
              price:
                amount: '50.0000000000000000'
                amount_without_discount: '100.0000000000000000'
                currency: USD
              quantity: 123
              sku: booster_mega_1
              type: virtual_good
              virtual_item_type: consumable
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Cart_inline_response_200_items'
          type: array
        price:
          $ref: '#/components/schemas/Cart_inline_response_200_price'
      type: object
    Cart-Payment_settings_currency:
      description: >-
        Предпочтительная валюта платежа. Используется трехбуквенное обозначение
        валюты согласно стандарту [ISO
        4217](https://en.wikipedia.org/wiki/ISO_4217).
      type: string
    Cart_inline_response_200_1_warnings:
      properties:
        errorCode:
          type: integer
        errorMessage:
          type: string
        quantity:
          type: integer
        sku:
          type: string
      type: object
    Cart_inline_response_200_1:
      properties:
        cart_id:
          description: ID корзины.
          example: cart_id
          type: string
        is_free:
          description: Если передано значение `true`, корзина бесплатная.
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/Cart_inline_response_200_items'
          type: array
        price:
          $ref: '#/components/schemas/Cart_inline_response_200_price'
        warnings:
          example:
            - attributes: []
              description: Take it, take it all! All of Xsollas riches in one Mega Booster.
              groups:
                - external_id: powerups
                  name: Power Ups
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
              inventory_options:
                consumable:
                  usages_count: 1
              is_free: false
              name: Xsolla Booster Mega
              price:
                amount: '50.0000000000000000'
                amount_without_discount: '100.0000000000000000'
                currency: USD
              quantity: 123
              sku: booster_mega_1
              type: virtual_good
              virtual_item_type: consumable
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Cart_inline_response_200_1_warnings'
          type: array
      type: object
    Cart_inline_response_404:
      properties:
        errorCode:
          example: 4001
          type: integer
        errorMessage:
          example: >-
            [0401-4001]: Item with Project ID = 44056 and SKU =
            booster_mega_12222 not found
          type: string
        statusCode:
          example: 404
          type: integer
      type: object
    Cart_inline_response_422_1:
      properties:
        errorCode:
          example: 1421
          type: integer
        errorMessage:
          example: >-
            This type of item cannot be put to the cart. Select another type of
            item.
          type: string
        statusCode:
          example: 422
          type: integer
      type: object
    Cart_inline_response_422:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: Item quantity must be non-negative integer.
          type: string
        statusCode:
          example: 422
          type: integer
      type: object
    Order_inline_response_200_1_content_price_1:
      description: Стоимость предмета.
      properties:
        amount:
          description: Цена предмета со скидкой.
          example: '30'
          type: string
        amount_without_discount:
          description: Стоимость предмета.
          example: '30'
          type: string
        currency:
          description: >-
            Валюта покупки по умолчанию. Используется трехбуквенное обозначение
            валюты согласно стандарту [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217).
          example: USD
          type: string
      type: object
    Order_inline_response_200_1_content_items:
      properties:
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: 'false'
          type: string
        price:
          $ref: '#/components/schemas/Order_inline_response_200_1_content_price_1'
        quantity:
          description: Количество этого предмета в заказе.
          example: 1
          type: integer
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: some_sku
          type: string
      type: object
    Order_inline_response_200_1_content_price:
      description: Стоимость заказа.
      properties:
        amount:
          description: Величина скидки на заказ.
          example: '30'
          type: string
        amount_without_discount:
          description: Стоимость заказа.
          example: '30'
          type: string
        currency:
          description: >-
            Валюта покупки по умолчанию. Используется трехбуквенное обозначение
            валюты согласно стандарту [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217).
          example: USD
          type: string
      type: object
    Order_inline_response_200_1_content_virtual_price:
      description: Стоимость заказа в виртуальной валюте.
      properties:
        amount:
          description: Величина скидки на заказ.
          example: '100'
          type: string
        amount_without_discount:
          description: Стоимость заказа.
          example: '150'
          type: string
        currency:
          description: Артикул виртуальной валюты, используемый в заказе.
          example: test_vc
          type: string
      type: object
    Order_inline_response_200_1_content:
      description: Детали заказа.
      properties:
        is_free:
          description: Если передано значение `true`, заказ бесплатный.
          example: 'false'
          type: string
        items:
          description: Список предметов.
          example:
            - is_free: false
              price:
                amount: '30'
                amount_without_discount: '30'
                currency: USD
              quantity: 1
              sku: some_sku
          items:
            $ref: '#/components/schemas/Order_inline_response_200_1_content_items'
          type: array
        price:
          $ref: '#/components/schemas/Order_inline_response_200_1_content_price'
        virtual_price:
          $ref: >-
            #/components/schemas/Order_inline_response_200_1_content_virtual_price
      type: object
    Order_inline_response_200_1:
      properties:
        content:
          $ref: '#/components/schemas/Order_inline_response_200_1_content'
        order_id:
          description: Идентификатор заказа.
          example: 1
          type: integer
        status:
          description: 'Статус заказа: `new` / `paid` / `done` / `canceled`.'
          example: paid
          type: string
      type: object
    Order_inline_response_404:
      properties:
        errorCode:
          example: 9001
          type: integer
        errorMessage:
          example: '[0401-9001]: Order not found'
          type: string
        statusCode:
          example: 404
          type: integer
      type: object
    Order_inline_response_200_billing_info_direct_tax:
      properties:
        amount:
          example: 150
          type: number
        name:
          example: TAX
          type: string
        rate:
          example: 10
          type: number
      type: object
    Order_inline_response_200_billing_info_indirect_tax:
      properties:
        amount:
          example: 246.75
          type: number
        name:
          example: VAT
          type: string
        rate:
          example: 20
          type: number
      type: object
    Order_inline_response_200_billing_info_price:
      properties:
        amount:
          example: 1480.45
          type: number
        currency:
          description: >-
            Валюта покупки. Используется трехбуквенное обозначение валюты
            согласно стандарту [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217).
          example: USD
          maxLength: 3
          minLength: 3
          type: string
      type: object
    Order_inline_response_200_billing_info:
      description: Платежная информация.
      properties:
        direct_tax:
          items:
            $ref: >-
              #/components/schemas/Order_inline_response_200_billing_info_direct_tax
          type: array
        indirect_tax:
          items:
            $ref: >-
              #/components/schemas/Order_inline_response_200_billing_info_indirect_tax
          type: array
        price:
          $ref: '#/components/schemas/Order_inline_response_200_billing_info_price'
      type: object
    Order_inline_response_200:
      properties:
        billing_info:
          $ref: '#/components/schemas/Order_inline_response_200_billing_info'
        order_id:
          description: Идентификатор заказа.
          type: integer
      type: object
    Order_inline_response_422:
      properties:
        errorCode:
          example: 1401
          type: integer
        errorMessage:
          example: '[0401-1401]: Invalid cart'
          type: string
        statusCode:
          example: 422
          type: integer
      type: object
    Order_inline_response_422_1:
      properties:
        errorCode:
          example: 1411
          type: integer
        errorMessage:
          example: '[0401-1411]: Invalid item'
          type: string
        statusCode:
          example: 422
          type: integer
      type: object
    email-required:
      properties:
        country:
          description: >-
            Двухбуквенный код страны в верхнем регистре согласно [ISO 3166-1
            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
          example: US
          nullable: true
          type: string
        email:
          description: >-
            Адрес электронной почты пользователя, на который он может получить
            купленный игровой ключ.
          example: public_email@test.com
          type: string
        id:
          description: Уникальный идентификатор пользователя в игре.
          example: public_id
          nullable: true
          type: string
        ip:
          description: IP-адрес пользователя.
          example: 127.0.0.1
          nullable: true
          type: string
        name:
          description: Имя пользователя в игре.
          example: Public name
          nullable: true
          type: string
        phone:
          description: Номер телефона пользователя.
          example: +66-000-000-00-00
          nullable: true
          type: string
      required:
        - email
    Common_inline_response_200_1:
      properties:
        token:
          description: Токен пользователя.
          type: string
      type: object
    Catalog_admin-attribute-external_id:
      description: >-
        Уникальный идентификатор атрибута. `external_id` может содержать только
        строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
      example: attribute_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9-_]+$
      type: string
    Catalog_value-external_id:
      description: >-
        Уникальный идентификатор атрибута. `external_id` может содержать только
        строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
      example: attribute_value
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
    Catalog_clientattributes_inner:
      properties:
        external_id:
          $ref: '#/components/schemas/Catalog_admin-attribute-external_id'
        name:
          description: Название атрибута.
          example: Genre
          type: string
        values:
          items:
            properties:
              external_id:
                $ref: '#/components/schemas/Catalog_value-external_id'
              value:
                description: Значение атрибута.
                example: Strategy
                type: string
            type: object
          type: array
      type: object
    Catalog_client-attributes-common:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих предмету. Может
        использоваться для фильтрации каталога.
      items:
        $ref: '#/components/schemas/Catalog_clientattributes_inner'
      type: array
    Catalog_bundle_type:
      description: Тип бандла. Всегда принимает значение `standart`.
      example: standart
      type: string
    Catalog_client_content_inner:
      description: Предмет в пакете.
      properties:
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        price:
          description: Стоимость предмета.
          nullable: true
          properties:
            amount:
              description: Цена предмета со скидкой.
              example: '100.99'
              type: string
            amount_without_discount:
              description: Стоимость предмета.
              example: '100.99'
              type: string
            currency:
              description: >-
                Валюта покупки по умолчанию. Используется трехбуквенное
                обозначение валюты согласно стандарту [ISO
                4217](https://en.wikipedia.org/wiki/ISO_4217).
              example: USD
              type: string
          type: object
        quantity:
          description: Количество предметов в пакете.
          example: 250
          type: integer
        sku:
          description: >-
            Уникальный идентификатор предмета (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_currency
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            description: Виртуальная цена.
            properties:
              amount:
                description: Стоимость предмета в виртуальной валюте со скидкой.
                example: 100
                type: integer
              amount_without_discount:
                description: Стоимость предмета.
                example: 200
                type: integer
              description:
                description: Описание виртуальной валюты.
                example: Big Rocket - description
                type: string
              image_url:
                description: Изображение виртуальной валюты.
                example: http://image.png
                type: string
              is_default:
                description: Является ли цена предмета ценой по умолчанию.
                example: true
                type: boolean
              name:
                description: Название виртуальной валюты.
                example: SHOTGUN FOR TRUE RAIDERS
                type: string
              sku:
                description: Артикул виртуальной валюты.
                example: vc_test
                type: string
              type:
                description: Тип виртуальной валюты.
                example: virtual_currency
                type: string
            type: object
          type: array
      type: object
    Catalog_client_content:
      description: Содержимое пакета бандлов.
      example:
        - attributes: []
          description: Big Rocket - short description.
          groups: []
          image_url: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          is_free: false
          name: Big Rocket
          price:
            amount: 10.99
            amount_without_discount: 10.99
            currency: USD
          quantity: 100
          sku: big_rocket
          type: virtual_currency
      items:
        $ref: '#/components/schemas/Catalog_client_content_inner'
      type: array
    Catalog_client_description:
      description: Описание предмета.
      example: Big Rocket - description.
      nullable: true
      type: string
    Catalog_groups_response_inner:
      properties:
        external_id:
          example: horror
          type: string
        name:
          example:
            en: Horror
          type: object
      type: object
    Catalog_groups_response:
      default: []
      description: Группы, к которым принадлежит предмет.
      example:
        - external_id: horror
          name:
            en: Horror
      items:
        $ref: '#/components/schemas/Catalog_groups_response_inner'
      type: array
    Catalog_image_url:
      description: URL изображения.
      example: https://image.example.com
      nullable: true
      type: string
    Catalog_is_free:
      default: 'false'
      description: Всегда `false`.
      example: 'false'
      type: string
    Catalog_client_name:
      description: Наименование предмета.
      example: Big Rocket
      type: string
    Catalog_amount:
      description: Цена предмета со скидкой.
      example: '100.99'
      pattern: ^\d*\.?\d*$
      type: string
    Catalog_amount_without_discount:
      description: Стоимость предмета.
      example: '100.99'
      pattern: ^\d*\.?\d*$
      type: string
    Catalog_currency:
      description: >-
        Валюта покупки. Используется трехбуквенное обозначение валюты согласно
        стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
      example: USD
      type: string
    Catalog_price:
      description: Стоимость предмета.
      nullable: true
      properties:
        amount:
          $ref: '#/components/schemas/Catalog_amount'
        amount_without_discount:
          $ref: '#/components/schemas/Catalog_amount_without_discount'
        currency:
          $ref: '#/components/schemas/Catalog_currency'
      required:
        - amount
        - amount_without_discount
        - currency
      type: object
    Catalog_sku:
      description: >-
        Уникальный идентификатор предмета. Артикул может содержать только
        строчные буквы латинского алфавита, цифры, точки, дефисы и
        подчеркивания.
      example: bundle_1
      type: string
    Catalog_total_content_price:
      description: Общая стоимость содержимого бандла.
      nullable: true
      properties:
        amount:
          description: Общая стоимость содержимого бандла со скидкой.
          example: '100.99'
          type: string
        amount_without_discount:
          description: Общая стоимость содержимого бандла.
          example: '100.99'
          type: string
        currency:
          $ref: '#/components/schemas/Catalog_currency'
      type: object
    Catalog_type:
      description: Тип предмета.
      example: bundle
      type: string
    Catalog_virtual_prices_inner:
      description: Виртуальная цена.
      properties:
        amount:
          description: Стоимость предмета в виртуальной валюте со скидкой.
          example: 100
          type: integer
        amount_without_discount:
          description: Цена предмета в виртуальной валюте.
          example: 200
          type: integer
        description:
          description: Описание виртуальной валюты.
          example: Most popular gold
          nullable: true
          type: string
        image_url:
          description: Изображение виртуальной валюты.
          example: http://image.png
          nullable: true
          type: string
        is_default:
          description: Является ли цена предмета ценой по умолчанию.
          example: true
          type: boolean
        name:
          description: Название виртуальной валюты.
          example: Gold
          type: string
        sku:
          description: Артикул виртуальной валюты.
          example: gold
          type: string
        type:
          description: Тип виртуальной валюты.
          example: virtual_currency
          type: string
      type: object
    Catalog_virtual_prices:
      description: Виртуальные цены.
      items:
        $ref: '#/components/schemas/Catalog_virtual_prices_inner'
      type: array
    Catalog_client_bundle:
      description: Указанный бандл.
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes-common'
        bundle_type:
          $ref: '#/components/schemas/Catalog_bundle_type'
        content:
          $ref: '#/components/schemas/Catalog_client_content'
        description:
          $ref: '#/components/schemas/Catalog_client_description'
        groups:
          $ref: '#/components/schemas/Catalog_groups_response'
        image_url:
          $ref: '#/components/schemas/Catalog_image_url'
        is_free:
          $ref: '#/components/schemas/Catalog_is_free'
        name:
          $ref: '#/components/schemas/Catalog_client_name'
        price:
          $ref: '#/components/schemas/Catalog_price'
        sku:
          $ref: '#/components/schemas/Catalog_sku'
        total_content_price:
          $ref: '#/components/schemas/Catalog_total_content_price'
        type:
          $ref: '#/components/schemas/Catalog_type'
        virtual_prices:
          $ref: '#/components/schemas/Catalog_virtual_prices'
      type: object
    Catalog_inline_response_200_10:
      description: Объект с предметами.
      properties:
        items:
          items:
            $ref: '#/components/schemas/Catalog_client_bundle'
          type: array
      type: object
    Catalog_inline_response_200_groups:
      properties:
        external_id:
          example: accessory
          type: string
        name:
          example: Accessory
          type: string
      type: object
    Catalog_inline_response_200_price:
      description: Стоимость предмета.
      properties:
        amount:
          description: Цена предмета со скидкой.
          example: '2.9900'
          type: string
        amount_without_discount:
          description: Стоимость предмета.
          example: '2.9900'
          type: string
        currency:
          description: >-
            Валюта покупки по умолчанию. Используется трехбуквенное обозначение
            валюты согласно стандарту [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217).
          example: USD
          type: string
      type: object
    Catalog_inline_response_200_virtual_prices:
      description: Виртуальная цена.
      properties:
        amount:
          description: Стоимость предмета в виртуальной валюте со скидкой.
          example: 100
          type: integer
        amount_without_discount:
          description: Стоимость предмета.
          example: 200
          type: integer
        description:
          description: Описание виртуальной валюты.
          example: Big Rocket - description
          type: string
        image_url:
          description: Изображение виртуальной валюты.
          example: http://image.png
          type: string
        is_default:
          description: Является ли стоимость предмета стоимостью по умолчанию.
          example: true
          type: boolean
        name:
          description: Название виртуальной валюты.
          example: SHOTGUN FOR TRUE RAIDERS
          type: string
        sku:
          description: Артикул виртуальной валюты.
          example: vc_test
          type: string
        type:
          description: Тип виртуальной валюты.
          example: virtual_currency
          type: string
      type: object
    Catalog_inline_response_200_unit_items:
      properties:
        drm_name:
          description: Название DRM.
          example: Steam
          type: string
        drm_sku:
          description: >-
            Уникальный идентификатор DRM (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: steam
          type: string
        has_keys:
          description: >-
            Если передано значение `true`, у игры на платформе есть ключи для
            продажи.
          example: false
          type: boolean
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: false
          type: boolean
        is_pre_order:
          description: >-
            Если передано значение `true`, игра на платформе доступна для
            предзаказа и дата выпуска еще не наступила.
          example: true
          type: boolean
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_price'
        release_date:
          description: Дата выпуска игры на платформе в формате ISO 8601.
          example: '2020-08-11T10:00:00+03:00'
          type: string
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: game_01
          type: string
        type:
          description: 'Тип предмета: `game_key`.'
          example: game_key
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes-common'
        description:
          description: Описание предмета.
          example: Game description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: all
              name: All games
            - external_id: Xsolla
              name: Xsolla game
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
          type: string
        name:
          description: Наименование предмета.
          example: Game name
          type: string
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: game_01
          type: string
        type:
          description: >-
            Тип предмета:
            `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
          example: unit
          type: string
        unit_items:
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_unit_items'
          type: array
        unit_type:
          description: 'Тип единицы: `game`.'
          example: game
          type: string
      type: object
    Catalog_inline_response_200:
      description: Объект с играми.
      properties:
        items:
          example:
            - attributes:
                $ref: '#/components/examples/client-attribute-game/Catalog_value'
              description: Game description
              groups:
                - external_id: all
                  name: All games
                - external_id: Xsolla
                  name: Xsolla games
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name: Game name
              sku: game_1
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam
                  has_keys: true
                  is_free: false
                  is_pre_order: true
                  price:
                    amount: '30.5'
                    amount_without_discount: '30.5'
                    currency: USD
                  release_date: '2020-08-11T10:00:00+03:00'
                  sku: game_key_01
                  type: game_key
                  virtual_prices: []
                - drm_name: Origin
                  drm_sku: origin
                  has_keys: false
                  is_free: false
                  is_pre_order: false
                  price:
                    amount: '30.5'
                    amount_without_discount: '30.5'
                    currency: USD
                  sku: game_key_02
                  type: game_key
                  virtual_prices: []
              unit_type: game
            - attributes:
                - external_id: OS
                  name: OS
                  values:
                    - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                      value: Windows
              description: Game description
              groups:
                - external_id: all
                  name: All games
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name: Game name
              sku: game_2
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam
                  has_keys: false
                  is_free: false
                  is_pre_order: false
                  price:
                    amount: '30.5'
                    amount_without_discount: '30.5'
                    currency: USD
                  sku: game_key_01
                  type: game_key
                  virtual_prices: []
              unit_type: game
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_items'
          type: array
      type: object
    Catalog_inline_response_200_4_drm:
      properties:
        drm_id:
          description: Идентификатор DRM.
          example: 1
          type: number
        image:
          description: URL изображения.
          example: >-
            https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
          type: string
        link:
          description: Ссылка на активацию.
          example: https://support.us.playstation.com
          type: string
        name:
          description: Название DRM.
          example: Steam
          type: string
        redeem_instruction_link:
          description: Ссылка на инструкцию по активации.
          example: https://support.us.playstation.com
          type: string
        sku:
          description: >-
            Уникальный идентификатор DRM (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: steam
          type: string
      type: object
    Catalog_inline_response_200_4:
      description: Объект с играми.
      properties:
        drm:
          example:
            - drm_id: 1
              image: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              link: https://support.steampowered.com
              name: Steam
              redeem_instruction_link: https://support.steampowered.com
              sku: steam
            - drm_id: 2
              image: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name: Playstation
              redeem_instruction_link: https://support.us.playstation.com
              sku: playstation
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_4_drm'
          type: array
      type: object
    Catalog_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих игре. 


        <div class="attention"><strong>Обратите внимание.</strong> Эта часть
        ответа доступна только в том случае, если вы передадите
        `additional_fields[]=attributes` в параметре запроса.</div>
      items:
        $ref: '#/components/schemas/Catalog_clientattributes_inner'
      type: array
    Catalog_inline_response_200_3_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        description:
          description: Описание предмета.
          example: Game description
          type: string
        drm_name:
          description: Название DRM.
          example: Steam
          type: string
        drm_sku:
          description: >-
            Уникальный идентификатор DRM (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: steam
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: all
              name: All games
            - external_id: Xsolla
              name: Xsolla game
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        has_keys:
          description: >-
            Если передано значение `true`, у игры на платформе есть ключи для
            продажи.
          example: false
          type: boolean
        image_url:
          description: URL изображения.
          example: >-
            https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
          type: string
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: false
          type: boolean
        is_pre_order:
          description: >-
            Если передано значение `true`, игра на платформе доступна для
            предзаказа и дата выпуска еще не наступила.
          example: true
          type: boolean
        name:
          description: Наименование предмета.
          example: Game name
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_price'
        release_date:
          description: Дата выпуска игры на платформе в формате ISO 8601.
          example: '2020-08-11T10:00:00+03:00'
          type: string
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: game_01
          type: string
        type:
          description: 'Тип предмета: `game_key`.'
          example: game_key
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_3:
      description: Объект с играми.
      properties:
        items:
          example:
            - attributes:
                $ref: >-
                  #/components/examples/client-attribute-game-horror/Catalog_value
              description: Game description
              drm_name: Steam
              drm_sku: steam
              groups:
                - external_id: all
                  name: All games
                - external_id: Xsolla
                  name: Xsolla games
              has_keys: true
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              is_free: false
              is_pre_order: true
              name: Game name
              price:
                amount: '30.5'
                amount_without_discount: '30.5'
                currency: USD
              release_date: '2020-08-11T10:00:00+03:00'
              sku: game_1
              type: game_key
              virtual_prices: []
            - attributes:
                $ref: >-
                  #/components/examples/client-attribute-game-horror/Catalog_value
              description: Game description
              drm_name: Steam
              drm_sku: steam
              groups:
                - external_id: all
                  name: All games
              has_keys: true
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              is_free: false
              is_pre_order: false
              name: Game name
              price:
                amount: '30.5'
                amount_without_discount: '30.5'
                currency: USD
              sku: game_2
              type: game_key
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_3_items'
          type: array
      type: object
    Catalog_inline_response_200_2:
      description: Объект с информацией об игре на платформе.
      example:
        attributes:
          $ref: '#/components/examples/client-attribute-game-horror/Catalog_value'
        description: Game description
        drm_name: Steam
        drm_sku: steam
        groups:
          - external_id: all
            name: All games
          - external_id: Xsolla
            name: Xsolla games
        has_keys: true
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
        is_free: false
        is_pre_order: true
        name: Game name
        price:
          amount: '30.5'
          amount_without_discount: '30.5'
          currency: USD
        release_date: '2020-08-11T10:00:00+03:00'
        sku: game_1
        type: game_key
        virtual_prices: []
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes-common'
        description:
          description: Описание предмета.
          example: Game description
          type: string
        drm_name:
          description: Название DRM.
          example: Steam
          type: string
        drm_sku:
          description: >-
            Уникальный идентификатор DRM (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: steam
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: all
              name: All games
            - external_id: Xsolla
              name: Xsolla game
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        has_keys:
          description: >-
            Если передано значение `true`, у игры на платформе есть ключи для
            продажи.
          example: false
          type: boolean
        image_url:
          description: URL изображения.
          example: >-
            https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
          type: string
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: false
          type: boolean
        is_pre_order:
          description: >-
            Если передано значение `true`, игра на платформе доступна для
            предзаказа и дата выпуска еще не наступила.
          example: true
          type: boolean
        name:
          description: Наименование предмета.
          example: Game name
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_price'
        release_date:
          description: Дата выпуска игры на платформе в формате ISO 8601.
          example: '2020-08-11T10:00:00+03:00'
          type: string
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: game_01
          type: string
        type:
          description: 'Тип предмета: `game_key`.'
          example: game_key
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_404_1:
      properties:
        errorCode:
          example: 4001
          type: integer
        errorMessage:
          example: '[0401-4001]: Item with sku = ''game_key_1'' not found'
          type: string
        statusCode:
          example: 404
          type: integer
      type: object
    Catalog_inline_response_200_1:
      description: Объект с информацией об игре.
      example:
        attributes:
          $ref: '#/components/examples/client-attribute-game/Catalog_value'
        description: Game description
        groups:
          - external_id: all
            name: All games
          - external_id: Xsolla
            name: Xsolla games
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
        name: Game name
        sku: game_1
        type: unit
        unit_items:
          - drm_name: Steam
            drm_sku: steam
            has_keys: true
            is_free: false
            is_pre_order: true
            price:
              amount: '30.5'
              amount_without_discount: '30.5'
              currency: USD
            release_date: '2020-08-11T10:00:00+03:00'
            sku: game_key_01
            type: game_key
            virtual_prices: []
          - drm_name: Origin
            drm_sku: origin
            has_keys: false
            is_free: false
            is_pre_order: false
            price:
              amount: '30.5'
              amount_without_discount: '30.5'
              currency: USD
            sku: game_key_02
            type: game_key
            virtual_prices: []
        unit_type: game
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        description:
          description: Описание предмета.
          example: Game description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: all
              name: All games
            - external_id: Xsolla
              name: Xsolla game
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
          type: string
        name:
          description: Наименование предмета.
          example: Game name
          type: string
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: game_01
          type: string
        type:
          description: >-
            Тип предмета:
            `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
          example: unit
          type: string
        unit_items:
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_unit_items'
          type: array
        unit_type:
          description: 'Тип единицы: `game`.'
          example: game
          type: string
      type: object
    Catalog_inline_response_404:
      properties:
        errorCode:
          example: 4001
          type: integer
        errorMessage:
          example: '[0401-4001]: Item with sku = ''game_1'' not found'
          type: string
        statusCode:
          example: 404
          type: integer
      type: object
    Catalog_inline_response_200_9_children:
      properties:
        children:
          description: Дочерние группы.
          example: []
          items:
            type: string
          type: array
        description:
          description: Описание группы.
          example: Accessory
          type: string
        external_id:
          description: Внешний идентификатор группы.
          example: accessory
          type: string
        image_url:
          description: URL изображения.
          type: string
        level:
          description: Уровень вложенности группы.
          example: 2
          type: integer
        name:
          description: Название группы.
          example: Accessory
          type: string
        order:
          description: Определяет порядок расположения.
          example: 1
          type: integer
        parent_external_id:
          description: Внешний идентификатор родительской группы.
          example: background
          type: string
      type: object
    Catalog_inline_response_200_9_children_1:
      properties:
        children:
          description: Дочерние группы.
          example:
            - children: []
              description: Accessory
              external_id: accessory
              level: 2
              name: Accessory
              order: 1
              parent_external_id: background
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_9_children'
          type: array
        description:
          description: Описание группы.
          example: Background description
          type: string
        external_id:
          description: Внешний идентификатор группы.
          example: background
          type: string
        image_url:
          description: URL-адрес изображения группы.
          type: string
        level:
          description: Уровень вложенности группы.
          example: 1
          type: integer
        name:
          description: Название группы.
          example: Background
          type: string
        order:
          description: Определяет порядок расположения.
          example: 1
          type: integer
        parent_external_id:
          description: Внешний идентификатор родительской группы.
          example: hair
          type: string
      type: object
    Catalog_inline_response_200_9_groups:
      properties:
        children:
          description: Дочерние группы.
          example:
            - children:
                - children: []
                  description: Accessory
                  external_id: accessory
                  level: 2
                  name: Accessory
                  order: 1
                  parent_external_id: background
              description: Background description
              external_id: background
              level: 1
              name: Background
              order: 1
              parent_external_id: hair
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_9_children_1'
          type: array
        description:
          description: Описание группы.
          example: Hair description
          type: string
        external_id:
          description: Внешний идентификатор группы.
          example: hair
          type: string
        image_url:
          description: URL изображения.
          type: string
        level:
          description: Уровень вложенности группы.
          example: 0
          type: integer
        name:
          description: Название группы.
          example: Hair
          type: string
        order:
          description: Определяет порядок расположения.
          example: 1
          type: integer
        parent_external_id:
          description: Внешний идентификатор родительской группы.
          type: string
      type: object
    Catalog_inline_response_200_9:
      properties:
        groups:
          example:
            - children:
                - children:
                    - children: []
                      description: Accessory
                      external_id: accessory
                      level: 2
                      name: Accessory
                      order: 1
                      parent_external_id: background
                  description: Background description
                  external_id: background
                  level: 1
                  name: Background
                  order: 1
                  parent_external_id: hair
              description: Hair description
              external_id: hair
              level: 0
              name: Hair
              order: 1
            - children: []
              description: Super description
              external_id: group_external_id
              level: 0
              name: Super
              order: 1
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_9_groups'
          type: array
      type: object
    Catalog_inline_response_200_5_inventory_options_consumable:
      description: >-
        Определяет, является ли предмет расходуемым или нерасходуемым, если
        передано значение `null`.
      nullable: true
      properties:
        usages_count:
          description: >-
            Общее количество оставшихся использований, если это расходуемый
            предмет, или `null`, если это нерасходуемый предмет.
          example: 1
          nullable: true
          type: integer
      type: object
    Catalog_inline_response_200_5_inventory_options_expiration_period:
      description: >-
        Если у предмета есть период действия, в этом объекте определяются
        настройки этого периода. Передайте `null`, если у предмета нет
        ограничений по периоду действия.
      nullable: true
      properties:
        type:
          description: Единица времени периода действия предмета.
          enum:
            - minute
            - hour
            - day
            - week
            - month
            - year
          example: day
          type: string
        value:
          description: Значение единицы времени периода действия предмета.
          example: 1
          type: integer
      type: object
    Catalog_inline_response_200_5_inventory_options:
      description: Определяет варианты для предметов инвентаря.
      properties:
        consumable:
          $ref: >-
            #/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable
        expiration_period:
          $ref: >-
            #/components/schemas/Catalog_inline_response_200_5_inventory_options_expiration_period
      type: object
    Catalog_inline_response_200_5_price:
      description: Стоимость предмета.
      properties:
        amount:
          description: Цена предмета со скидкой.
          example: '100.99'
          type: string
        amount_without_discount:
          description: Стоимость предмета.
          example: '100.99'
          type: string
        currency:
          description: >-
            Валюта покупки по умолчанию. Используется трехбуквенное обозначение
            валюты согласно стандарту [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217).
          example: USD
          type: string
      type: object
    Catalog_inline_response_200_6_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: accessory
              name: Accessory
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        inventory_options:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_inventory_options'
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: 'false'
          type: string
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_price'
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_currency
          type: string
        virtual_prices:
          description: Виртуальные цены.
          example:
            - amount: 100
              amount_without_discount: 100
              image_url: http://image.png
              is_default: true
              sku: shotgun_raider
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_6:
      properties:
        items:
          example:
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - value: '5'
              description: Big Rocket - short description
              groups:
                - external_id: accessory
                  name: Accessory
              image_url: >-
                https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
              inventory_options:
                consumable:
                  usages_count: 1
              is_free: false
              name: Big Rocket
              price:
                amount: '100.99'
                amount_without_discount: '100.99'
                currency: USD
              sku: big_rocket
              type: virtual_currency
              virtual_prices:
                - amount: 100
                  amount_without_discount: 100
                  description: description
                  image_url: http://image.png
                  is_default: true
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: shotgun_raider
                  type: virtual_currency
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - value: '1'
                - external_id: rating
                  name: Rating
                  values:
                    - value: '3.9'
                - external_id: genre
                  name: Genre
                  values:
                    - value: Strategy
                    - value: Tactical
                    - Turn-based
              description: description
              groups:
                - external_id: hair
                  name: Hair
              image_url: http://image.png
              inventory_options:
                consumable:
                  usages_count: 1
              is_free: false
              name: SHOTGUN FOR TRUE RAIDERS
              price:
                amount: '101.0'
                amount_without_discount: '101.0'
                currency: USD
              sku: shotgun_raider
              type: virtual_currency
              virtual_prices: []
            - attributes: []
              description: description
              groups: []
              image_url: http://image.png
              inventory_options:
                consumable:
                  usages_count: 1
              is_free: true
              name: SHOTGUN FOR TRUE RAIDERS
              sku: shotgun_raider_2
              type: virtual_currency
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_6_items'
          type: array
      type: object
    Catalog_inline_response_200_7_inventory_options_expiration_period:
      description: >-
        Если у предмета есть период действия, в этом объекте определяются
        настройки этого периода. Передайте `null`, если у предмета нет
        ограничений по периоду действия.
      nullable: true
      properties:
        type:
          description: Единица времени периода действия предмета.
          enum:
            - minute
            - hour
            - day
            - week
            - month
            - year
          example: day
          type: string
        value:
          description: Значение единицы времени периода действия предмета.
          example: 1
          type: integer
      type: object
    Catalog_inline_response_200_7_inventory_options:
      description: Определяет варианты для предметов инвентаря.
      properties:
        consumable:
          $ref: >-
            #/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable
        expiration_period:
          $ref: >-
            #/components/schemas/Catalog_inline_response_200_7_inventory_options_expiration_period
      type: object
    Catalog_inline_response_200_7_content:
      description: Виртуальная валюта в пакете.
      properties:
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        inventory_options:
          $ref: '#/components/schemas/Catalog_inline_response_200_7_inventory_options'
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        quantity:
          description: Количество виртуальной валюты в пакете.
          example: 250
          type: integer
        sku:
          description: >-
            Уникальный идентификатор предмета (артикул). Может содержать только
            строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_currency
          type: string
      type: object
    Catalog_inline_response_200_7_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        bundle_type:
          description: 'Тип бандла: `standard`/`virtual_currency_package`.'
          example: virtual_currency_package
          type: string
        content:
          description: Содержимое пакета виртуальной валюты.
          example:
            - description: Big Rocket - short description
              image_url: >-
                https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
              inventory_options:
                consumable:
                  usages_count: 1
              name: Big Rocket
              quantity: 100
              sku: big_rocket
              type: virtual_currency
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_7_content'
          type: array
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: accessory
              name: Accessory
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: 'false'
          type: string
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_price'
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.'
          example: bundle
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_7:
      description: Объект с предметами.
      properties:
        items:
          example:
            - attributes: []
              bundle_type: virtual_currency_package
              content:
                - description: Big Rocket - short description
                  image_url: >-
                    https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                  inventory_options:
                    consumable:
                      usages_count: 1
                  name: Big Rocket
                  quantity: 100
                  sku: big_rocket
                  type: virtual_currency
              description: VC Short Package Description
              groups: []
              image_url: http://vc_package_image.png
              is_free: false
              name: VC Name first package
              price:
                amount: '2.0000'
                amount_without_discount: '2.0000'
                currency: USD
              sku: vc_package_1
              type: bundle
              virtual_prices: []
            - attributes: []
              bundle_type: virtual_currency_package
              content:
                - description: description
                  image_url: http://image.png
                  inventory_options:
                    consumable:
                      usages_count: 1
                  name: SHOTGUN FOR TRUE RAIDERS
                  quantity: 200
                  sku: shotgun_raider
                  type: virtual_currency
              description: VC Short Package Description
              groups: []
              image_url: http://vc_package_image.png
              is_free: false
              name: VC Name third package
              price:
                amount: '4.0000'
                amount_without_discount: '4.0000'
                currency: USD
              sku: vc_package_3
              type: bundle
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_7_items'
          type: array
      type: object
    Catalog_inline_response_200_5_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: accessory
              name: Accessory
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        inventory_options:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_inventory_options'
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: false
          type: boolean
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_price'
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_good
          type: string
        virtual_item_type:
          description: Тип виртуального предмета.
          enum:
            - consumable
            - non_consumable
            - non_renewing_subscription
          example: non-consumable
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_5:
      description: Объект с виртуальными предметами.
      properties:
        items:
          example:
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                      value: '5'
              description: Big Rocket - description
              groups:
                - external_id: accessory
                  name: Accessory
              image_url: >-
                https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
              inventory_options:
                consumable:
                  usages_count: 1
                expiration_period:
                  type: day
                  value: 1
              is_free: false
              name: Big Rocket
              price:
                amount: '100.99'
                amount_without_discount: '100.99'
                currency: USD
              sku: big_rocket
              type: virtual_good
              virtual_item_type: non_renewing_subscription
              virtual_prices:
                - amount: 100
                  amount_without_discount: 100
                  description: description
                  image_url: http://image.png
                  is_default: true
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test
                  type: virtual_currency
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                      value: '5'
                - external_id: rating
                  name: Rating
                  values:
                    - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                      value: '3.9'
              description: description
              groups:
                - external_id: hair
                  name: Hair
              image_url: http://image.png
              inventory_options:
                consumable:
                  usages_count: 1
                expiration_period:
                  type: day
                  value: 1
              is_free: false
              name: SHOTGUN FOR TRUE RAIDERS
              price:
                amount: '101.0'
                amount_without_discount: '101.0'
                currency: USD
              sku: shotgun_raider
              type: virtual_good
              virtual_item_type: non_renewing_subscription
              virtual_prices:
                - amount: 100
                  amount_without_discount: 100
                  description: description
                  image_url: http://image.png
                  is_default: true
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test
                  type: virtual_currency
                - amount: 200
                  amount_without_discount: 200
                  description: description
                  image_url: http://image.png
                  is_default: false
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test_2
                  type: virtual_currency
            - attributes: []
              description: description
              groups: []
              image_url: http://image.png
              inventory_options:
                consumable:
                  usages_count: 1
                expiration_period:
                  type: day
                  value: 1
              is_free: true
              name: SHOTGUN FOR TRUE RAIDERS
              sku: shotgun_raider_2
              type: virtual_good
              virtual_item_type: non_renewing_subscription
              virtual_prices: []
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_5_items'
          type: array
      type: object
    Catalog_inline_response_200_8_virtual_prices:
      description: Виртуальная цена.
      properties:
        amount:
          description: Стоимость предмета в виртуальной валюте со скидкой.
          example: 100
          type: integer
        amount_without_discount:
          description: Стоимость предмета.
          example: 200
          type: integer
        description:
          description: Описание виртуальной валюты.
          example: Big Rocket - description
          type: string
        image_url:
          example: http://image.png
          type: string
        is_default:
          description: Является ли стоимость предмета стоимостью по умолчанию.
          example: true
          type: boolean
        name:
          description: Название виртуальной валюты.
          example: SHOTGUN FOR TRUE RAIDERS
          type: string
        sku:
          description: Артикул виртуальной валюты.
          example: vc_test
          type: string
        type:
          description: Тип виртуальной валюты.
          example: virtual_currency
          type: string
      type: object
    Catalog_inline_response_200_8_items:
      properties:
        attributes:
          $ref: '#/components/schemas/Catalog_client-attributes'
        description:
          description: Описание предмета.
          example: Big Rocket - description
          type: string
        groups:
          description: Группы, к которым принадлежит предмет.
          example:
            - external_id: accessory
              name: Accessory
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_groups'
          type: array
        image_url:
          description: URL изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        inventory_options:
          $ref: '#/components/schemas/Catalog_inline_response_200_7_inventory_options'
        is_free:
          description: Если передано значение `true`, предмет бесплатный.
          example: 'false'
          type: string
        name:
          description: Наименование предмета.
          example: Big Rocket
          type: string
        price:
          $ref: '#/components/schemas/Catalog_inline_response_200_5_price'
        sku:
          description: >-
            Уникальный идентификатор предмета. Артикул может содержать только
            строчные буквы латинского алфавита, цифры, точки, дефисы и
            подчеркивания.
          example: big_rocket
          type: string
        type:
          description: >-
            Тип предмета:
            `consumable`/`expiration`/`permanent`/`lootboxes`/`physical`.
          example: virtual_good
          type: string
        virtual_item_type:
          description: Тип виртуального предмета.
          enum:
            - consumable
            - non_consumable
            - non_renewing_subscription
          example: non_consumable
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_8_virtual_prices'
          type: array
      type: object
    Catalog_inline_response_200_8:
      properties:
        items:
          example:
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - value: '5'
              description: Big Rocket - description
              groups:
                - external_id: accessory
                  name: Accessory
              image_url: >-
                https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
              inventory_options:
                consumable:
                  usages_count: 1
                expiration_period:
                  type: day
                  value: 1
              is_free: false
              name: Big Rocket
              price:
                amount: '100.99'
                amount_without_discount: '100.99'
                currency: USD
              sku: big_rocket
              type: virtual_good
              virtual_item_type: non_renewing_subscription
              virtual_prices:
                - amount: 100
                  amount_without_discount: 100
                  description: description
                  image_url: http://image.png
                  is_default: true
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test
                  type: virtual_currency
            - attributes:
                - external_id: stack_size
                  name: Stack size
                  values:
                    - value: '5'
                - external_id: rating
                  name: Rating
                  values:
                    - value: '3.9'
                - external_id: genre
                  name: Genre
                  values:
                    - value: Strategy
                    - value: Tactical
                    - Turn-based
              description: description
              groups:
                - external_id: accessory
                  name: Accessory
              image_url: http://image.png
              inventory_options:
                consumable:
                  usages_count: 1
                expiration_period:
                  type: day
                  value: 1
              is_free: false
              name: SHOTGUN FOR TRUE RAIDERS
              price:
                amount: '101.0'
                amount_without_discount: '101.0'
                currency: USD
              sku: shotgun_raider
              type: virtual_good
              virtual_item_type: non_renewing_subscription
              virtual_prices:
                - amount: 100
                  amount_without_discount: 100
                  description: description
                  image_url: http://image.png
                  is_default: true
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test
                  type: virtual_currency
                - amount: 200
                  amount_without_discount: 200
                  description: description
                  image_url: http://image.png
                  is_default: false
                  name: SHOTGUN FOR TRUE RAIDERS
                  sku: vc_test_2
                  type: virtual_currency
          items:
            $ref: '#/components/schemas/Catalog_inline_response_200_8_items'
          type: array
      type: object
    Catalog_inline_response_404_2:
      properties:
        errorCode:
          example: 4403
          type: integer
        errorMessage:
          example: '[0401-4403]: Item group not found'
          type: string
        statusCode:
          example: 404
          type: integer
      type: object
  requestBodies:
    fill-cart-json-model:
      content:
        application/json:
          schema:
            example:
              - quantity: 123
                sku: booster_mega_1
            properties:
              currency:
                $ref: '#/components/schemas/Cart-Payment_settings_currency'
              items:
                description: Список предметов.
                items:
                  minItems: 1
                  properties:
                    quantity:
                      default: 123
                      type: number
                    sku:
                      default: booster_mega_1
                      type: string
                  required:
                    - quantity
                    - sku
                  type: object
                type: array
            required:
              - items
            type: object
    put-item-by-cart-id-json-model:
      content:
        application/json:
          schema:
            properties:
              currency:
                $ref: '#/components/schemas/Cart-Payment_settings_currency'
              quantity:
                default: 123
                description: Количество этого предмета в заказе.
                type: number
            type: object
    create-order-model:
      content:
        application/json:
          schema:
            example:
              geotype: 13038
            properties:
              currency:
                $ref: '#/components/schemas/Cart-Payment_settings_currency'
              geotype:
                description: Идентификатор партнера-дистрибьютора на стороне Иксоллы.
                type: number
              quantity:
                description: Количество этого предмета в заказе.
                example: 1
                type: integer
            required:
              - geotype
              - currency
            type: object
      description: Объект с данными для создания заказа.
      required: true
    post-user-token-json-model:
      content:
        application/json:
          schema:
            properties:
              user:
                $ref: '#/components/schemas/email-required'
                description: Объект с информацией о пользователе.
                type: object
            required:
              - user
            type: object
  examples:
    200-get-bundle-list:
      value:
        items:
          - attributes:
              external_id: genre
              name: Genre
              values:
                - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
                  value: Casual
                - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
                  value: Strategy
                - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
                  value: Mobile
            bundle_type: standard
            content:
              - attributes:
                  external_id: size
                  name: Size
                  values:
                    - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                      value: Large
                description: Big Rocket - short description.
                groups: []
                image_url: >-
                  https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                is_free: false
                name: Big Rocket
                price:
                  amount: 10.99
                  amount_without_discount: 10.99
                  currency: USD
                quantity: 100
                sku: big_rocket
                type: virtual_currency
                virtual_item_type: non_consumable
                virtual_prices: []
            description: pricePoint_44056_1
            groups: []
            is_free: false
            media_list: []
            name: kg_10.00_bundle
            order: 999
            price:
              amount: 9.99
              amount_without_discount: 9.99
              currency: USD
            sku: kg_1
            total_content_price:
              amount: 10.99
              amount_without_discount: 10.99
              currency: USD
            type: bundle
            virtual_prices: []
    200-get-bundle:
      value:
        attributes: []
        bundle_type: standard
        content:
          - attributes: []
            description: Big Rocket - short description.
            groups: []
            image_url: >-
              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
            is_free: false
            name: Big Rocket
            price:
              amount: 10.99
              amount_without_discount: 10.99
              currency: USD
            quantity: 100
            sku: big_rocket
            type: virtual_currency
            virtual_prices: []
        description: pricePoint_44056_1.
        groups: []
        is_free: false
        media_list: []
        name: kg_10.00_bundle
        order: 999
        price:
          amount: 9.99
          amount_without_discount: 9.99
          currency: USD
        sku: kg_1
        total_content_amount:
          amount: 10.99
          amount_without_discount: 10.99
          currency: USD
        type: bundle
        virtual_prices: []
x-tagGroups:
  - name: Корзина
    tags:
      - cart
  - name: Каталог
    tags:
      - game keys
      - virtual items & currency
      - bundles
  - name: Общие
    tags:
      - user token
  - name: Уведомления
    tags:
      - notifications
  - name: Заказ
    tags:
      - order
