# Предоставление товаров пользователям ввиду покупки

Добавляет указанные товары в инвентари указанных пользователей ввиду покупки.

ВниманиеОдновременно может быть обработано только 50 операций. Операции сверх данного ограничения будут игнорироваться.

Endpoint: POST /v2/project/{project_id}/inventory/purchase
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID проекта.

## Request fields (application/json):

  - `comment` (string)
    Описание операции. Пример: "Ежемесячные награды за участие в испытаниях".

  - `custom_parameters` (object)
    Дополнительные пользовательские параметры проекта.
    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"}}

  - `items` (array, required)

  - `items.quantity` (number, required)
    Количество товаров этого класса, которое необходимо предоставить.

  - `items.sku` (string, required)
    Идентификатор класса товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.

  - `platform` (string)
    Платформа публикации, на которой играет пользователь.
    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"

  - `purchase` (object, required)

  - `purchase.amount` (string, required)
    Сумма покупки до каких-либо вычетов.

  - `purchase.currency` (string, required)
    Валюта покупки согласно [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.external_purchase_date` (string, required)
    Дата покупки согласно ISO 8601.

  - `purchase.external_purchase_id` (string, required)
    Идентификатор заявки на покупку с платформы, на которой была совершена покупка.

  - `user` (object, required)

  - `user.id` (string)
    Уникальный идентификатор пользователя на платформе.

## Response 200 fields (application/json):

  - `count` (integer)
    Example: 10

  - `operations` (array)

  - `operations.amount` (string)
    Сумма покупки до каких-либо вычетов.
    Example: "2.99"

  - `operations.comment` (string)
    Описание операции. Пример: "Ежемесячные награды за участие в испытаниях".
    Example: "Montly challange rewards"

  - `operations.currency` (string)
    Валюта покупки согласно [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `operations.custom_parameters` (object)
    Дополнительные пользовательские параметры проекта.
    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"}}

  - `operations.external_purchase_date` (string)
    Дата покупки согласно ISO 8601.
    Example: "2020-01-01T05:00:00+05:00"

  - `operations.external_purchase_id` (string)
    Идентификатор заявки на покупку с платформы, на которой была совершена покупка.
    Example: "10-534-35"

  - `operations.items` (array)

  - `operations.items.quantity` (integer)
    Количество товаров этого класса, которое необходимо предоставить.
    Example: 1

  - `operations.items.sku` (string)
    Идентификатор класса товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.
    Example: "com.xsolla.item_1"

  - `operations.order_id` (number)
    Описание операции на стороне Иксоллы.
    Example: 123456

  - `operations.platform` (string)
    Платформа публикации, на которой играет пользователь.
    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"

  - `operations.user_id` (string)
    Уникальный идентификатор пользователя на платформе.
    Example: "d.user"

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Код ошибки.
    Example: 1102

  - `errorMessage` (string)
    Сообщение об ошибке.
    Example: "[0401-1102]: Unprocessable Entity. The property sku is required"

  - `statusCode` (integer)
    Example: 422