components:
  examples:
    Player-Inventory_inventory_purchase_request_example:
      value:
        - purchase:
            amount: '3.5'
            comment: xsolla
            currency: USD
            custom_parameters:
              - user_device_info:
                  engine_version: Unity 2020.2.0b5
                  os: windows
                user_public_id:
                  nickname: player1
              - comment: xsolla
                custom_parameters:
                  content_creator_rewards:
                    - content_creator:
                        id: cc1
                      reward:
                        amount: '10.00'
                        currency: USD
                    - content_creator:
                        id: cc2
                      reward:
                        amount: '15.00'
                        currency: RUB
                items:
                  - quantity: 5
                    sku: com.xsolla.panda_sdk3
                  - quantity: 3
                    sku: com.xsolla.panda_sdk2
                platform: xsolla
                purchase:
                  amount: '3.5'
                  currency: USD
                  external_purchase_date: '2020-01-01T00:00:00+05:00'
                  external_purchase_id: '1000001'
                user:
                  id: 83857636-65b4-11e8-9ccb-42010a8a001c
            external_purchase_date: '2020-01-01T00:00:00+05:00'
            external_purchase_id: '1000000'
            items:
              - quantity: 5
                sku: com.xsolla.panda_sdk1
              - quantity: 3
                sku: com.xsolla.panda_sdk2
            platform: xsolla
            user:
              id: 672c91cd-65db-4b6e-ad68-6e93b21249d8
  parameters:
    limit-query-param:
      description: Лимит количества элементов на странице.
      example: 50
      in: query
      name: limit
      required: false
      schema:
        example: 50
        minimum: 1
        type: integer
    offset-query-param:
      description: >-
        Номер элемента, с которого выполняется вывод на странице (нумерация
        ведется с 0).
      example: 0
      in: query
      name: offset
      required: false
      schema:
        example: 0
        minimum: 0
        type: integer
    project_id-path-param:
      description: >-
        ID проекта. Вы можете найти этот параметр в [Личном
        кабинете](https://publisher.xsolla.com/) рядом с названием проекта.
      in: path
      name: project_id
      required: true
      schema:
        example: 44056
        type: integer
  responses:
    Player-Inventory_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
  schemas:
    Player-Inventory_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:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Player-Inventory_custom_parameters:
      additionalProperties:
        oneOf:
          - type: array
          - type: object
          - type: string
          - type: integer
          - type: 'null'
          - type: number
          - type: boolean
      description: Дополнительные пользовательские параметры проекта.
      example:
        array_param:
          - user_device_info:
              engine_version: Unity 2020.2.0b5
              os: windows
            user_public_id:
              nickname: player1
          - user_device_info:
              engine_version: UE 4.25
              os: mac
            user_public_id:
              nickname: player1
        bool_param: true
        int_param: 100
        null_param: null
        object_param:
          key: value
      maxProperties: 200
      minProperties: 1
      type: object
    admin-attribute-external_id:
      description: >-
        Уникальный ID атрибута. `external_id` может содержать только строчные и
        заглавные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9-_]+$
      type: string
    value-external_id:
      description: >-
        Уникальный ID значения атрибута. `external_id` может содержать только
        строчные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_value
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
  securitySchemes:
    XsollaLoginUserJWT:
      bearerFormat: JWT
      description: >-
        По умолчанию для авторизации используется JWT пользователя Авторизации
        Иксолла 

        (Bearer-токен). Вы можете попробовать вызвать этот метод с помощью
        тестового 

        токена JWT пользователя Авторизации Иксолла: `Bearer
        eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`.


        В качестве альтернативы вы можете использовать [Pay Station access 

        token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/).
      scheme: bearer
      type: http
    basicAuth:
      description: >
        Xsolla API использует базовую аутентификацию. Все запросы к API должны 

        содержать заголовок `Authorization: Basic
        <your_authorization_basic_key>`, где 

        `your_authorization_basic_key` — пара `project_id:api_key`,
        закодированная по 

        стандарту Base64.


        Вы можете использовать `merchant_id` вместо, `project_id` при
        необходимости. 

        Это не влияет на функциональность.


        Значения параметров вы можете найти в [Личном 

        кабинете](https://publisher.xsolla.com/):


        * `merchant_id` отображается:
          * В разделе **Настройки компании > Компания**
          * В URL-адресе в адресной строке браузера на любой странице учетной записи 
            издателя. URL-адрес имеет следующий формат: 
            `https://publisher.xsolla.com/<merchant_id>`.
        * `api_key` отображается в Личном кабинете только при создании и должен
        храниться 
          на вашей стороне. Создать ключ можно в разделах:
          * **Настройки компании > Ключи API**
          * **Настройки проекта > Ключи API**
        * `project_id` отображается:
          * В Личном кабинете рядом с названием проекта.
          * В URL-адресе в адресной строке браузера при работе над проектом в учетной 
            записи издателя. URL-адрес имеет следующий формат: 
            `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.

        Подробная информация о работе с ключами API приведена в [справочнике 

        API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview).
      scheme: basic
      type: http
info:
  description: >-
    # Overview


    * **Version:** 2.0.0

    * **Servers**: `https://store.xsolla.com/api`

    * **[Contact Us by Email](mailto:integration@xsolla.com)**

    * **Contact URL:** https://xsolla.com/

    * **Required TLS version:** 1.2


    Shop Builder API provides a third-party solution for implementing

    the server side for your store interface. Use the endpoints to manage
    in-game items,

    in-game currencies, cart, player inventory, promotions, game library, etc.
  title: Shop Builder API
  version: 2.0.0
openapi: 3.0.0
paths:
  /v2/project/{project_id}/inventory/account/link:
    post:
      description: Соединяет игровой аккаунт пользователя с аккаунтом Иксоллы.
      operationId: inventory-account-link
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              properties:
                linking_code:
                  description: >-
                    Код привязки. Необходим пользователям для подтверждения
                    подключения их аккаунта к аккаунту Иксоллы.
                  example: 53LRH2
                  type: string
                platform:
                  description: Платформа публикации, на которой играет пользователь.
                  enum:
                    - playstation_network
                    - xbox_live
                    - xsolla
                    - pc_standalone
                    - nintendo_shop
                    - google_play
                    - app_store_ios
                    - android_standalone
                    - ios_standalone
                    - android_other
                    - ios_other
                    - pc_other
                  example: xbox_live
                  type: string
                user_id:
                  description: ID пользователя на платформе публикации, где он играет.
                  example: platform_user_id
                  type: string
              required:
                - linking_code
                - platform
                - user_id
              type: object
        required: true
      responses:
        '204':
          description: Игровой аккаунт пользователя успешно соединен с аккаунтом Иксоллы.
        '401':
          $ref: '#/components/responses/Player-Inventory_401-invalid-basic-auth'
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1102
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property
                      publisher_project_id is required
                    statusCode: 422
              schema:
                properties:
                  errorCode:
                    example: 1102
                    type: integer
                  errorMessage:
                    example: >-
                      [0401-1102]: Unprocessable Entity. The property
                      publisher_project_id is required
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                type: object
          description: >-
            Свойство `linking_code` является обязательным. Убедитесь, что
            передали его в своем запросе.
      security:
        - basicAuth: []
      summary: Подключение игрового аккаунта к Иксолле
      tags:
        - cross-inventory
      x-badges:
        - color: '#95ff80'
          name: Server-side
  /v2/project/{project_id}/inventory/account/signin:
    post:
      description: >-
        Получает JWT для работы с Shop Builder API для пользователей вашей
        платформы публикации.
      operationId: inventory-account-signin
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              properties:
                platform:
                  description: Платформа публикации, на которой играет пользователь.
                  enum:
                    - playstation_network
                    - xbox_live
                    - xsolla
                    - pc_standalone
                    - nintendo_shop
                    - google_play
                    - app_store_ios
                    - android_standalone
                    - ios_standalone
                    - android_other
                    - ios_other
                    - pc_other
                  example: xbox_live
                  type: string
                user_id:
                  description: ID пользователя на платформе публикации, где он играет.
                  example: platform_user_id
                  type: string
              required:
                - user_id
                - platform
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  token:
                    example: >-
                      eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI
                    type: string
                type: object
          description: Игровой аккаунт пользователя успешно токенизирован.
        '401':
          $ref: '#/components/responses/Player-Inventory_401-invalid-basic-auth'
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 1102
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property
                      publisher_project_id is required
                    statusCode: 422
              schema:
                properties:
                  errorCode:
                    example: 1102
                    type: integer
                  errorMessage:
                    example: >-
                      [0401-1102]: Unprocessable Entity. The property
                      publisher_project_id is required
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                type: object
          description: >-
            Свойство `user_id` является обязательным. Убедитесь, что передали
            его в своем запросе.
      security:
        - basicAuth: []
      summary: Токенизация пользователя
      tags:
        - cross-inventory
      x-badges:
        - color: '#95ff80'
          name: Server-side
  /v2/project/{project_id}/inventory/purchase:
    post:
      description: >-
        Добавляет указанные товары в инвентари указанных пользователей ввиду
        покупки.


        <div class="notice"><strong>Внимание</strong><br><br>Одновременно может
        быть обработано <strong>только 50 операций</strong>. Операции сверх
        данного ограничения будут игнорироваться.</div>
      operationId: grant-item-by-purchase
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            examples:
              example:
                $ref: >-
                  #/components/examples/Player-Inventory_inventory_purchase_request_example
            schema:
              items:
                properties:
                  comment:
                    default: Monthly challenge rewards
                    description: >-
                      Описание операции. Пример: "Ежемесячные награды за участие
                      в испытаниях".
                    maxLength: 255
                    minLength: 1
                    type: string
                  custom_parameters:
                    $ref: '#/components/schemas/Player-Inventory_custom_parameters'
                  items:
                    items:
                      properties:
                        quantity:
                          default: 1
                          description: >-
                            Количество товаров этого класса, которое необходимо
                            предоставить.
                          type: number
                        sku:
                          default: booster_mega_1
                          description: >-
                            Идентификатор класса товара. Артикул может содержать
                            только строчные латинские буквы, цифры, точки, тире
                            и подчеркивания.
                          type: string
                      required:
                        - sku
                        - platform
                        - quantity
                      type: object
                    minItems: 1
                    type: array
                  platform:
                    default: xsolla
                    description: Платформа публикации, на которой играет пользователь.
                    enum:
                      - playstation_network
                      - xbox_live
                      - xsolla
                      - pc_standalone
                      - nintendo_shop
                      - google_play
                      - app_store_ios
                      - android_standalone
                      - ios_standalone
                      - android_other
                      - ios_other
                      - pc_other
                    type: string
                  purchase:
                    properties:
                      amount:
                        default: '2.99'
                        description: Сумма покупки до каких-либо вычетов.
                        type: string
                      currency:
                        default: USD
                        description: >-
                          Валюта покупки согласно [ISO
                          4217](https://en.wikipedia.org/wiki/ISO_4217).
                        type: string
                      external_purchase_date:
                        default: '2020-01-01T05:00:00+05:00'
                        description: Дата покупки согласно ISO 8601.
                        type: string
                      external_purchase_id:
                        default: 10-534-35
                        description: >-
                          Идентификатор заявки на покупку с платформы, на
                          которой была совершена покупка.
                        type: string
                    required:
                      - amount
                      - currency
                      - external_purchase_id
                      - external_purchase_date
                    type: object
                  user:
                    properties:
                      id:
                        default: d342dad2-9d59-11e9-a384-42010aa8003f
                        description: Уникальный идентификатор пользователя на платформе.
                        type: string
                    type: object
                required:
                  - user
                  - items
                  - purchase
                type: object
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 2
                    operations:
                      - amount: '2.99'
                        comment: Quest completed
                        currency: USD
                        custom_parameters:
                          array_param:
                            - user_device_info:
                                engine_version: Unity 2020.2.0b5
                                os: windows
                              user_public_id:
                                nickname: player1
                            - user_device_info:
                                engine_version: UE 4.25
                                os: mac
                              user_public_id:
                                nickname: player2
                        external_purchase_date: '2020-01-01T05:00:00+05:00'
                        external_purchase_id: 10-534-35
                        items:
                          - quantity: 5
                            sku: com.xsolla.boots_1
                          - quantity: 3
                            sku: com.xsolla.crystal_pack_1
                        order_id: 123456
                        platform: xbox_live
                        user_id: 0125760a-6810-11e9-84c0-42010aa80029
                      - amount: '2.99'
                        comment: Daily reward
                        currency: USD
                        custom_parameters: null
                        external_purchase_date: '2020-01-01T05:00:00+05:00'
                        external_purchase_id: 10-534-35
                        items:
                          - quantity: 2
                            sku: com.xsolla.helmet_1
                          - quantity: 3
                            sku: com.xsolla.minigun_1
                        order_id: 123457
                        platform: xbox_live
                        user_id: a7d10a4e-3f68-43cc-a6b2-893d2c68fd14
              schema:
                properties:
                  count:
                    example: 10
                    type: integer
                  operations:
                    items:
                      properties:
                        amount:
                          description: Сумма покупки до каких-либо вычетов.
                          example: '2.99'
                          type: string
                        comment:
                          description: >-
                            Описание операции. Пример: "Ежемесячные награды за
                            участие в испытаниях".
                          example: Montly challange rewards
                          type: string
                        currency:
                          description: >-
                            Валюта покупки согласно [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                        custom_parameters:
                          $ref: >-
                            #/components/schemas/Player-Inventory_custom_parameters
                        external_purchase_date:
                          description: Дата покупки согласно ISO 8601.
                          example: '2020-01-01T05:00:00+05:00'
                          type: string
                        external_purchase_id:
                          description: >-
                            Идентификатор заявки на покупку с платформы, на
                            которой была совершена покупка.
                          example: 10-534-35
                          type: string
                        items:
                          items:
                            properties:
                              quantity:
                                description: >-
                                  Количество товаров этого класса, которое
                                  необходимо предоставить.
                                example: 1
                                type: integer
                              sku:
                                description: >-
                                  Идентификатор класса товара. Артикул может
                                  содержать только строчные латинские буквы,
                                  цифры, точки, тире и подчеркивания.
                                example: com.xsolla.item_1
                                type: string
                            type: object
                          type: array
                        order_id:
                          description: Описание операции на стороне Иксоллы.
                          example: 123456
                          type: number
                        platform:
                          description: >-
                            Платформа публикации, на которой играет
                            пользователь.
                          enum:
                            - playstation_network
                            - xbox_live
                            - xsolla
                            - pc_standalone
                            - nintendo_shop
                            - google_play
                            - app_store_ios
                            - android_standalone
                            - ios_standalone
                            - android_other
                            - ios_other
                            - pc_other
                          example: xbox_live
                          type: string
                        user_id:
                          description: Уникальный идентификатор пользователя на платформе.
                          example: d.user
                          type: string
                      type: object
                    type: array
                type: object
          description: Успешная покупка пользователем.
        '422':
          content:
            application/json:
              schema:
                items:
                  properties:
                    errorCode:
                      description: Код ошибки.
                      example: 1102
                      type: integer
                    errorMessage:
                      description: Сообщение об ошибке.
                      example: >-
                        [0401-1102]: Unprocessable Entity. The property sku is
                        required
                      type: string
                    statusCode:
                      example: 422
                      type: integer
                  type: object
                type: array
            incorrect_format_input_data:
              examples:
                response:
                  value:
                    errorCode: 1102
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property sku is
                      required
                    statusCode: 422
          description: Необрабатываемая сущность.
      security:
        - basicAuth: []
      summary: Предоставление товаров пользователям ввиду покупки
      tags:
        - inventory-management
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/inventory/revoke:
    post:
      description: >-
        Отзывает права доступа к товарам для нескольких пользователей.


        <div class="notice"><strong>Внимание</strong><br><br>Одновременно может
        быть обработано <strong>только 50 операций</strong>. Операции сверх
        данного ограничения будут игнорироваться.</div>
      operationId: revoke-item
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              items:
                properties:
                  comment:
                    default: Item was transferred to another player
                    description: >-
                      Описание операции. Пример: "Товар был передан другому
                      игроку".
                    maxLength: 255
                    minLength: 1
                    type: string
                  items:
                    items:
                      properties:
                        quantity:
                          default: 1
                          description: >-
                            Количество товаров этого класса, которое необходимо
                            изъять.
                          minimum: 1
                          type: integer
                        sku:
                          default: booster_mega_1
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          minLength: 1
                          type: string
                      required:
                        - sku
                        - quantity
                      type: object
                    minItems: 1
                    type: array
                  platform:
                    default: xsolla
                    description: Платформа публикации, на которой играет пользователь.
                    enum:
                      - playstation_network
                      - xbox_live
                      - xsolla
                      - pc_standalone
                      - nintendo_shop
                      - google_play
                      - app_store_ios
                      - android_standalone
                      - ios_standalone
                      - android_other
                      - ios_other
                      - pc_other
                    example: xsolla
                    type: string
                  user:
                    properties:
                      id:
                        default: d342dad2-9d59-11e9-a384-42010aa8003f
                        description: Уникальный идентификатор пользователя на платформе.
                        type: string
                    type: object
                required:
                  - user
                  - items
                type: object
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 2
                    operations:
                      - comment: Remove from inventory
                        items:
                          - balance: 3
                            quantity: 5
                            sku: com.xsolla.boots_1
                          - balance: 5
                            quantity: 3
                            sku: com.xsolla.crystal_pack_1
                        platform: xsolla
                        user_id: 0125760a-6810-11e9-84c0-42010aa80029
                      - comment: Cheater
                        items:
                          - balance: 0
                            quantity: 2
                            sku: com.xsolla.helmet_1
                          - balance: 0
                            quantity: 3
                            sku: com.xsolla.minigun_1
                        platform: xsolla
                        user_id: a7d10a4e-3f68-43cc-a6b2-893d2c68fd14
              schema:
                properties:
                  count:
                    description: >-
                      Количество пользователей, чьи товары были успешно
                      отозваны.
                    example: 10
                    type: integer
                  operations:
                    description: Описание операций.
                    items:
                      properties:
                        comment:
                          description: >-
                            Описание операции. Пример: "Товар был передан
                            другому игроку".
                          example: Some comment for this operation
                          type: string
                        items:
                          description: Товары в данной операции.
                          items:
                            properties:
                              balance:
                                description: >-
                                  Общее количество товаров этого класса,
                                  находящихся во владении пользователя.
                                example: 1
                                type: integer
                              quantity:
                                description: Количество изъятых товаров этого класса.
                                example: 1
                                type: integer
                              sku:
                                description: >-
                                  Идентификатор класса товара. Артикул может
                                  содержать только строчные латинские буквы,
                                  цифры, точки, тире и подчеркивания.
                                example: com.xsolla.item_1
                                type: string
                            type: object
                          type: array
                        platform:
                          default: xsolla
                          enum:
                            - playstation_network
                            - xbox_live
                            - xsolla
                            - pc_standalone
                            - nintendo_shop
                            - google_play
                            - app_store_ios
                            - android_standalone
                            - ios_standalone
                            - android_other
                            - ios_other
                            - pc_other
                          example: xbox_live
                          type: string
                        user_id:
                          description: Уникальный идентификатор пользователя на платформе.
                          example: d.user
                          type: string
                      type: object
                    type: array
                type: object
          description: Пользовательские товары отозваны успешно.
        '404':
          content:
            application/json:
              schema:
                items:
                  properties:
                    errorCode:
                      description: Код ошибки.
                      example: 4001
                      type: integer
                    errorMessage:
                      description: Сообщение об ошибке.
                      example: >-
                        [0401-5004]: Could not find instance in inventory: Could
                        not remove 10, user only has 1
                      type: string
                    statusCode:
                      example: 404
                      type: integer
                  type: object
                type: array
            incorrect_format_input_data:
              examples:
                response:
                  value:
                    errorCode: 1104
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property sku is
                      required
                    statusCode: 404
            many_items:
              examples:
                response:
                  value:
                    errorCode: 5004
                    errorMessage: >-
                      [0401-4001]: Could not find item for project 44056 with id
                      armor_max ()
                    statusCode: 404
            not_found_user:
              examples:
                response:
                  value:
                    errorCode: 0
                    errorMessage: Could not find User
                    statusCode: 404
            remove_many:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: >-
                      [0401-5004]: Could not find instance in inventory: Could
                      not remove 10, user only has 1
                    statusCode: 404
          description: Не удалось удалить такое количество товаров.
      security:
        - basicAuth: []
      summary: Изъятие товаров из инвентаря
      tags:
        - inventory-management
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/inventory/reward:
    post:
      description: >-
        Добавляет указанные товары в инвентари указанных пользователей.


        <div class="notice"><strong>Внимание</strong><br><br>Одновременно может
        быть обработано <strong>только 50 операций</strong>. Операции сверх
        данного ограничения будут игнорироваться.</div>
      operationId: add-item-to-inventory
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              items:
                properties:
                  comment:
                    default: Monthly challenge rewards
                    description: >-
                      Описание операции. Пример: "Ежемесячные награды за участие
                      в испытаниях".
                    maxLength: 255
                    minLength: 1
                    type: string
                  items:
                    items:
                      properties:
                        quantity:
                          default: 1
                          description: >-
                            Количество товаров этого класса, которое необходимо
                            предоставить.
                          type: number
                        sku:
                          default: booster_mega_1
                          description: >-
                            Идентификатор класса товара. Артикул может содержать
                            только строчные латинские буквы, цифры, точки, тире
                            и подчеркивания.
                          type: string
                      required:
                        - sku
                        - platform
                        - quantity
                      type: object
                    minItems: 1
                    type: array
                  platform:
                    default: xsolla
                    description: Платформа публикации, на которой играет пользователь.
                    enum:
                      - playstation_network
                      - xbox_live
                      - xsolla
                      - pc_standalone
                      - nintendo_shop
                      - google_play
                      - app_store_ios
                      - android_standalone
                      - ios_standalone
                      - android_other
                      - ios_other
                      - pc_other
                    type: string
                  user:
                    properties:
                      id:
                        default: d342dad2-9d59-11e9-a384-42010aa8003f
                        description: Уникальный идентификатор пользователя на платформе.
                        type: string
                    type: object
                required:
                  - user
                  - items
                type: object
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 2
                    operations:
                      - comment: Quest completed
                        items:
                          - balance: 5
                            quantity: 5
                            sku: com.xsolla.boots_1
                          - balance: 3
                            quantity: 3
                            sku: com.xsolla.crystal_pack_1
                        platform: xsolla
                        user_id: 0125760a-6810-11e9-84c0-42010aa80029
                      - comment: Daily reward
                        items:
                          - balance: 5
                            quantity: 2
                            sku: com.xsolla.helmet_1
                          - balance: 5
                            quantity: 3
                            sku: com.xsolla.minigun_1
                        platform: xsolla
                        user_id: a7d10a4e-3f68-43cc-a6b2-893d2c68fd14
              schema:
                properties:
                  count:
                    example: 10
                    type: integer
                  operations:
                    items:
                      properties:
                        comment:
                          description: >-
                            Описание операции. Пример: "Ежемесячные награды за
                            участие в испытаниях".
                          example: Montly challange rewards
                          type: string
                        items:
                          items:
                            properties:
                              balance:
                                description: >-
                                  Общее количество товаров этого класса,
                                  находящихся во владении пользователя.
                                example: 5
                                type: integer
                              quantity:
                                description: >-
                                  Количество товаров этого класса, которое
                                  необходимо предоставить.
                                example: 1
                                type: integer
                              sku:
                                description: >-
                                  Идентификатор класса товара. Артикул может
                                  содержать только строчные латинские буквы,
                                  цифры, точки, тире и подчеркивания.
                                example: com.xsolla.item_1
                                type: string
                            type: object
                          type: array
                        platform:
                          description: >-
                            Платформа публикации, на которой играет
                            пользователь.
                          enum:
                            - null
                            - playstation_network
                            - xbox_live
                            - xsolla
                            - pc_standalone
                            - nintendo_shop
                            - google_play
                            - app_store_ios
                            - android_standalone
                            - ios_standalone
                            - android_other
                            - ios_other
                            - pc_other
                          example: xbox_live
                          nullable: true
                          type: string
                        user_id:
                          description: Уникальный идентификатор пользователя на платформе.
                          example: d.user
                          type: string
                      type: object
                    type: array
                type: object
          description: Пользователь успешно вознагражден.
        '404':
          content:
            application/json:
              schema:
                items:
                  properties:
                    errorCode:
                      description: Код ошибки.
                      example: 4001
                      type: integer
                    errorMessage:
                      description: Сообщение об ошибке.
                      example: >-
                        [0401-4001]: Could not find item for project 44056 with
                        id armor_max ()
                      type: string
                    statusCode:
                      example: 404
                      type: integer
                  type: object
                type: array
            incorrect_format_input_data:
              examples:
                response:
                  value:
                    errorCode: 1104
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property sku is
                      required
                    statusCode: 404
            many_items:
              examples:
                response:
                  value:
                    errorCode: 5004
                    errorMessage: >-
                      [0401-4001]: Could not find item for project 44056 with id
                      armor_max ()
                    statusCode: 404
            not_found_user:
              examples:
                response:
                  value:
                    errorCode: 0
                    errorMessage: Could not find User
                    statusCode: 404
          description: Товар для проекта не найден.
      security:
        - basicAuth: []
      summary: Предоставление товаров пользователям
      tags:
        - inventory-management
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/inventory/set:
    post:
      description: >-
        Наполняет инвентари указанных пользователей указанными товарами.
        Обратите внимание, что новые данные заменят старые.


        <div class="notice"><strong>Внимание</strong><br><br>Одновременно может
        быть обработано <strong>только 50 операций</strong>. Операции сверх
        данного ограничения будут игнорироваться.</div>
      operationId: set-item-quantity
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              items:
                properties:
                  comment:
                    default: Monthly inventory syncing
                    description: >-
                      Описание операции. Пример: "Ежемесячная синхронизация
                      инвентаря".
                    maxLength: 255
                    minLength: 1
                    type: string
                  items:
                    items:
                      properties:
                        quantity:
                          default: 1
                          description: >-
                            Количество товаров этого класса, которое необходимо
                            предоставить.
                          type: number
                        sku:
                          default: booster_mega_1
                          description: >-
                            Идентификатор класса товара. Артикул может содержать
                            только строчные латинские буквы, цифры, точки, тире
                            и подчеркивания.
                          type: string
                      required:
                        - sku
                        - platform
                        - quantity
                      type: object
                    minItems: 1
                    type: array
                  platform:
                    default: xsolla
                    description: Платформа публикации, на которой играет пользователь.
                    enum:
                      - playstation_network
                      - xbox_live
                      - xsolla
                      - pc_standalone
                      - nintendo_shop
                      - google_play
                      - app_store_ios
                      - android_standalone
                      - ios_standalone
                      - android_other
                      - ios_other
                      - pc_other
                    type: string
                  user:
                    properties:
                      id:
                        default: d342dad2-9d59-11e9-a384-42010aa8003f
                        description: Уникальный идентификатор пользователя на платформе.
                        type: string
                    type: object
                required:
                  - user
                  - items
                type: object
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 2
                    operations:
                      - comment: Monthly inventory syncing
                        items:
                          - balance: 5
                            quantity: 5
                            sku: com.xsolla.boots_1
                          - balance: 3
                            quantity: 3
                            sku: com.xsolla.crystal_pack_1
                        platform: xsolla
                        user_id: 0125760a-6810-11e9-84c0-42010aa80029
                      - comment: Monthly inventory syncing
                        items:
                          - balance: 2
                            quantity: 2
                            sku: com.xsolla.helmet_1
                          - balance: 3
                            quantity: 3
                            sku: com.xsolla.minigun_1
                        platform: xsolla
                        user_id: a7d10a4e-3f68-43cc-a6b2-893d2c68fd14
              schema:
                properties:
                  count:
                    example: 10
                    type: integer
                  operations:
                    items:
                      properties:
                        comment:
                          description: >-
                            Описание операции. Пример: "Ежедневная синхронизация
                            инвентаря".
                          example: Daily inventory syncing
                          type: string
                        items:
                          items:
                            properties:
                              balance:
                                description: >-
                                  Общее количество товаров этого класса,
                                  находящихся во владении пользователя.
                                example: 5
                                type: integer
                              quantity:
                                description: >-
                                  Количество товаров этого класса, которое
                                  необходимо предоставить.
                                example: 1
                                type: integer
                              sku:
                                description: >-
                                  Идентификатор класса товара. Артикул может
                                  содержать только строчные латинские буквы,
                                  цифры, точки, тире и подчеркивания.
                                example: com.xsolla.item_1
                                type: string
                            type: object
                          type: array
                        platform:
                          description: >-
                            Платформа публикации, на которой играет
                            пользователь.
                          enum:
                            - playstation_network
                            - xbox_live
                            - xsolla
                            - pc_standalone
                            - nintendo_shop
                            - google_play
                            - app_store_ios
                            - android_standalone
                            - ios_standalone
                            - android_other
                            - ios_other
                            - pc_other
                          example: xbox_live
                          type: string
                        user_id:
                          description: Уникальный идентификатор пользователя на платформе.
                          example: d.user
                          type: string
                      type: object
                    type: array
                type: object
          description: Успешная операция.
        '404':
          content:
            application/json:
              schema:
                items:
                  properties:
                    errorCode:
                      description: Код ошибки.
                      example: 4001
                      type: integer
                    errorMessage:
                      description: Сообщение об ошибке.
                      example: >-
                        [0401-4001]: Could not find item for project 44056 with
                        id armor_max ()
                      type: string
                    statusCode:
                      example: 404
                      type: integer
                  type: object
                type: array
            incorrect_format_input_data:
              examples:
                response:
                  value:
                    errorCode: 1104
                    errorMessage: >-
                      [0401-1102]: Unprocessable Entity. The property sku is
                      required
                    statusCode: 404
            many_items:
              examples:
                response:
                  value:
                    errorCode: 5004
                    errorMessage: >-
                      [0401-4001]: Could not find item for project 44056 with id
                      armor_max ()
                    statusCode: 404
            not_found_user:
              examples:
                response:
                  value:
                    errorCode: 0
                    errorMessage: Could not find User
                    statusCode: 404
          description: Товар для проекта не найден.
      security:
        - basicAuth: []
      summary: Настройка товаров для пользователей
      tags:
        - inventory-management
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/user/inventory/item/consume:
    post:
      description: Метод клиента. Расходует предмет из инвентаря текущего пользователя.
      operationId: consume-item
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
        - description: Платформа публикации, на которой играет пользователь.
          in: query
          name: platform
          required: false
          schema:
            default: xsolla
            enum:
              - playstation_network
              - xbox_live
              - xsolla
              - pc_standalone
              - nintendo_shop
              - google_play
              - app_store_ios
              - android_standalone
              - ios_standalone
              - android_other
              - ios_other
              - pc_other
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                quantity:
                  default: 1
                  description: Количество товара.
                  example: 1
                  type: number
                sku:
                  default: booster_mega_1
                  description: >-
                    Уникальный ID товара. Артикул может содержать только
                    строчные и заглавные латинские буквы, цифры, точки, тире и
                    подчеркивания.
                  example: booster_mega_1
                  type: string
              required:
                - sku
                - quantity
              type: object
      responses:
        '200':
          description: Товар из инвентаря пользователя израсходован.
        '404':
          content:
            application/json:
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku = gun_5
                      not found
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
            application/json 1:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku = gun_5
                      not found
                    statusCode: 404
            application/json 2:
              examples:
                response:
                  value:
                    errorCode: 5004
                    errorMessage: >-
                      [0401-5004]: Could not find instance in inventory: Could
                      not remove 112299999344, user only has 12
                    statusCode: 404
          description: >-
            Товар вообще не был найден, товар не был найден в инвентаре или его
            недостаточно (попытка израсходовать больше первоначального
            количества).
        '422':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 5002
                    errorMessage: '[0401-5002]: Quantity and item_id/sku must be specified'
                    statusCode: 422
              schema:
                properties:
                  errorCode:
                    example: 5002
                    type: integer
                  errorMessage:
                    example: '[0401-5002]: Quantity and item_id/sku must be specified'
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                type: object
          description: Убедитесь, что переданы параметры `quantity` и `sku`.
      security:
        - XsollaLoginUserJWT: []
      summary: Расходование предмета
      tags:
        - inventory-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/inventory/items:
    get:
      description: >-
        Метод клиента. Получает инвентарь текущего пользователя.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div>
      operationId: get-user-inventory
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - description: Платформа публикации, на которой играет пользователь.
          in: query
          name: platform
          required: false
          schema:
            default: xsolla
            enum:
              - playstation_network
              - xbox_live
              - xsolla
              - pc_standalone
              - nintendo_shop
              - google_play
              - app_store_ios
              - android_standalone
              - ios_standalone
              - android_other
              - ios_other
              - pc_other
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - attributes: []
                        description: Big Rocket - short description
                        groups: []
                        image_url: https://picture.bigrocket.png
                        instance_id: null
                        name: Rocket
                        quantity: null
                        remaining_uses: 1
                        sku: com.xsolla.instanciated_item_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes: []
                        description: description
                        groups: []
                        image_url: http://image.png
                        instance_id: null
                        name: SHOTGUN FOR TRUE RAIDERS
                        quantity: 2
                        remaining_uses: 1
                        sku: com.xsolla.shotgun_raider_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: >-
                                  stack_size_value_99c25352ab6e34a0e0755fc2a9daa7a76021dce2
                                value: 5
                          - external_id: licensed
                            name: Licensed
                            values:
                              - external_id: >-
                                  licensed_value_d75d8034dd2f82cb3d2789f5ec1837a6c350b505
                                value: true
                        description: null
                        groups: []
                        image_url: null
                        instance_id: null
                        name: HEADPHONES
                        quantity: 5
                        remaining_uses: 1
                        sku: com.xsolla.headphones_for_pro_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes: []
                        description: null
                        groups: []
                        image_url: null
                        instance_id: null
                        name: UNIQUE DIAMONDS
                        quantity: 100
                        remaining_uses: 1
                        sku: com.xsolla.platform_currency_1
                        type: virtual_currency
              schema:
                properties:
                  items:
                    example:
                      - attributes: []
                        description: Big Rocket - short description
                        groups: []
                        image_url: https://picture.bigrocket.png
                        instance_id: null
                        name: Rocket
                        quantity: null
                        remaining_uses: 1
                        sku: com.xsolla.instanciated_item_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes: []
                        description: description
                        groups: []
                        image_url: http://image.png
                        instance_id: null
                        name: SHOTGUN FOR TRUE RAIDERS
                        quantity: 2
                        remaining_uses: 1
                        sku: com.xsolla.shotgun_raider_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes:
                          - external_id: stack_size
                            name: Stack size
                            values:
                              - external_id: >-
                                  stack_size_value_99c25352ab6e34a0e0755fc2a9daa7a76021dce2
                                value: 5
                          - external_id: licensed
                            name: Licensed
                            values:
                              - external_id: >-
                                  licensed_value_d75d8034dd2f82cb3d2789f5ec1837a6c350b505
                                value: true
                        description: null
                        groups: []
                        image_url: null
                        instance_id: null
                        name: HEADPHONES
                        quantity: 5
                        remaining_uses: 1
                        sku: com.xsolla.headphones_for_pro_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      - attributes: []
                        description: null
                        groups: []
                        image_url: null
                        instance_id: null
                        name: UNIQUE DIAMONDS
                        quantity: 100
                        remaining_uses: 1
                        sku: com.xsolla.platform_currency_1
                        type: virtual_currency
                    items:
                      properties:
                        attributes:
                          $ref: >-
                            #/components/schemas/Player-Inventory_client-attributes
                        description:
                          description: Описание товара.
                          example: Big Rocket - short description
                          type: string
                        groups:
                          description: Группы, к которым принадлежит товар.
                          example:
                            - external_id: accessory
                              name: Accessory
                          items:
                            properties:
                              external_id:
                                example: accessory
                                type: string
                              name:
                                example: Accessory
                                type: string
                            type: object
                          type: array
                        image_url:
                          description: URL изображения.
                          example: https://picture.bigrocket.png
                          type: string
                        instance_id:
                          deprecated: true
                          description: Устаревший параметр. Всегда `null`.
                          type: 'null'
                        name:
                          description: Название товара.
                          example: Rocket
                          type: string
                        quantity:
                          description: Количество товара.
                          example: null
                          nullable: true
                          type: integer
                        remaining_uses:
                          description: >-
                            Определяет условия расходования: количество
                            оставшихся использований, если это расходуемый
                            предмет, или `null`, если это нерасходуемый предмет.
                          example: 1
                          nullable: true
                          type: integer
                        sku:
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          example: com.xsolla.instanciated_item_1
                          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
                          nullable: true
                          type: string
                      type: object
                    type: array
                type: object
          description: Инвентарь пользователя успешно получен.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение инвентаря текущего пользователя
      tags:
        - inventory-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/time_limited_items:
    get:
      description: >-
        Метод клиента. Получает для текущего пользователя предметы с
        ограниченным сроком действия.
      operationId: get-user-subscriptions
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
        - description: Платформа публикации, на которой играет пользователь.
          in: query
          name: platform
          required: false
          schema:
            default: xsolla
            enum:
              - playstation_network
              - xbox_live
              - xsolla
              - pc_standalone
              - nintendo_shop
              - google_play
              - app_store_ios
              - android_standalone
              - ios_standalone
              - android_other
              - ios_other
              - pc_other
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - description: >-
                          The PLEX or “30-day Pilot's License EXtension” is a
                          virtual item that represents 30 days of subscription
                          time and can be bought for cash and then sold to other
                          players for in-game ISK.
                        expired_at: 1746057600
                        image_url: https://picture.bigrocket.png
                        name: PLEX
                        sku: com.xsolla.plex_1
                        status: active
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                      - description: >-
                          WoW token allows players to buy game time World of
                          Warcraft for money and sell it for game gold at
                          auction.
                        expired_at: 1546304461
                        image_url: https://picture.bigrocket.png
                        name: WoW Token
                        sku: com.xsolla.token_1
                        status: expired
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                      - amount: 10
                        description: >-
                          Premium. Premium Status provides a character with
                          several benefits allowing faster overall progression.
                        expired_at: null
                        image_url: https://picture.bigrocket.png
                        name: Premium account
                        sku: com.xsolla.premium_item_1
                        status: none
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
              schema:
                properties:
                  items:
                    example:
                      - amount: 10
                        description: Ruble
                        image_url: https://picture.bigrocket.png
                        name: Ruble
                        sku: com.xsolla.VC_1
                        type: virtual_currency
                        virtual_item_type: non_renewing_subscription
                      - amount: 5000
                        description: Xsollar
                        image_url: http://image.png
                        name: Xsollar
                        sku: com.xsolla.VC_2
                        type: virtual_currency
                        virtual_item_type: non_renewing_subscription
                    items:
                      properties:
                        description:
                          description: Описание товара.
                          example: >-
                            Premium. Premium Status provides a character with
                            several benefits allowing faster overall
                            progression.
                          type: string
                        expired_at:
                          description: >-
                            Временная метка Unix. Дата истечения срока действия
                            предмета с ограниченным сроком действия. Если у
                            пользователя нет данного предмета, то значение равно
                            `null`.
                          example: 1746057600
                          type: integer
                        image_url:
                          description: URL изображения.
                          example: https://picture.bigrocket.png
                          type: string
                        name:
                          description: Название подписки.
                          example: Premium status
                          type: string
                        sku:
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          example: com.xsolla.premium_item_1
                          type: string
                        status:
                          description: >-
                            Статус предмета с ограниченным сроком действия.

                            Предмет может иметь один из трех статусов:

                            - `none` - не куплен.

                            - `active` - активен.

                            - `expired` - был куплен, но срок его действия
                            истек.
                          example: active
                          type: string
                        type:
                          description: 'Тип товара: `virtual_good`.'
                          example: virtual_good
                          type: string
                        virtual_item_type:
                          description: Тип виртуального предмета.
                          enum:
                            - consumable
                            - non_consumable
                            - non_renewing_subscription
                          example: non_consumable
                          type: string
                          x-enumDescriptions:
                            consumable: >-
                              Предмет исчезает из инвентаря после использования
                              (например, патроны).
                            non_consumable: >-
                              Предмет остается в инвентаре в течение
                              неограниченного времени.
                            non_renewing_subscription: >-
                              Предмет с ограниченным сроком действия, который
                              может служить представлением доступа к сервисам
                              или контенту в течение ограниченного периода
                              времени.
                      type: object
                    type: array
                type: object
          description: >-
            Предметы с ограниченным сроком действия для пользователя успешно
            получены.
      security:
        - XsollaLoginUserJWT: []
      summary: >-
        Получение для текущего пользователя предметов с ограниченным сроком
        действия
      tags:
        - inventory-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/virtual_currency_balance:
    get:
      description: Метод клиента. Получает виртуальный баланс текущего пользователя.
      operationId: get-user-virtual-balance
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
        - description: Платформа публикации, на которой играет пользователь.
          in: query
          name: platform
          required: false
          schema:
            default: xsolla
            enum:
              - playstation_network
              - xbox_live
              - xsolla
              - pc_standalone
              - nintendo_shop
              - google_play
              - app_store_ios
              - android_standalone
              - ios_standalone
              - android_other
              - ios_other
              - pc_other
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - amount: 10
                        description: Ruble
                        image_url: https://picture.bigrocket.png
                        name: Ruble
                        sku: com.xsolla.VC_1
                        type: virtual_currency
                      - amount: 5000
                        description: Xsollar
                        image_url: http://image.png
                        name: Xsollar
                        sku: com.xsolla.VC_2
                        type: virtual_currency
              schema:
                properties:
                  items:
                    example:
                      - description: >-
                          The PLEX or “30-day Pilot's License EXtension” is a
                          virtual item that represents 30 days of subscription
                          time and can be bought for cash and then sold to other
                          players for in-game ISK.
                        expired_at: 1746057600
                        image_url: https://picture.bigrocket.png
                        name: PLEX
                        sku: com.xsolla.plex_1
                        status: active
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                      - description: >-
                          WoW token allows players to buy game time World of
                          Warcraft for money and sell it for game gold at
                          auction.
                        expired_at: 1546304461
                        image_url: https://picture.bigrocket.png
                        name: WoW Token
                        sku: com.xsolla.token_1
                        status: expired
                        type: virtual_good
                        virtual_item_type: non_renewing_subscription
                    items:
                      properties:
                        amount:
                          description: Количество товара.
                          example: null
                          type: integer
                        description:
                          description: Описание товара.
                          example: Big Rocket - short description
                          type: string
                        image_url:
                          description: URL изображения.
                          example: https://picture.bigrocket.png
                          type: string
                        name:
                          description: Название товара.
                          example: Rocket
                          type: string
                        sku:
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          example: com.xsolla.instanciated_item_1
                          type: string
                        type:
                          description: >-
                            Тип товара:
                            `virtual_good`/`virtual_currency`/`bundle`.
                          example: virtual_currency
                          type: string
                      type: object
                    type: array
                type: object
          description: Виртуальный баланс пользователя успешно получен.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение виртуального баланса текущего пользователя
      tags:
        - inventory-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
servers:
  - url: https://store.xsolla.com/api
tags:
  - name: inventory-client
    x-displayName: Клиент
  - name: inventory-management
    x-displayName: Управление
  - name: cross-inventory
    x-displayName: Кроссплатформенный инвентарь
