# Conceder itens por compras aos usuários

Adiciona os itens especificados por compra aos inventários de usuários especificados.

AtençãoApenas 50 operações podem ser processadas de uma só vez. As operações que excederem esse limite serão ignoradas.

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

## Path parameters:

  - `project_id` (integer, required)
    ID do projeto.

## Request fields (application/json):

  - `comment` (string)
    Descrição da operação. Por exemplo: "Recompensas mensais por desafio".

  - `custom_parameters` (object)
    Parâmetros específicos do projeto.
    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)
    Número de itens dessa classe que precisava ser concedido.

  - `items.sku` (string, required)
    Identificador de classe de item. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.

  - `platform` (string)
    Plataforma de publicação em que o usuário joga.
    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)
    Valor da compra antes de qualquer dedução.

  - `purchase.currency` (string, required)
    Moeda de compra no padrão [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.external_purchase_date` (string, required)
    Data de compra no padrão ISO 8601.

  - `purchase.external_purchase_id` (string, required)
    Identificador de fatura de compra da plataforma em que uma compra foi feita.

  - `user` (object, required)

  - `user.id` (string)
    O identificador de usuário exclusivo na plataforma.

## Response 200 fields (application/json):

  - `count` (integer)
    Example: 10

  - `operations` (array)

  - `operations.amount` (string)
    Valor da compra antes de qualquer dedução.
    Example: "2.99"

  - `operations.comment` (string)
    Descrição da operação. Por exemplo: "Recompensas mensais por desafio".
    Example: "Montly challange rewards"

  - `operations.currency` (string)
    Moeda de compra no padrão [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `operations.custom_parameters` (object)
    Parâmetros específicos do projeto.
    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)
    Data de compra no padrão ISO 8601.
    Example: "2020-01-01T05:00:00+05:00"

  - `operations.external_purchase_id` (string)
    Identificador de fatura de compra da plataforma em que uma compra foi feita.
    Example: "10-534-35"

  - `operations.items` (array)

  - `operations.items.quantity` (integer)
    Número de itens dessa classe que precisava ser concedido.
    Example: 1

  - `operations.items.sku` (string)
    Identificador de classe de item. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.
    Example: "com.xsolla.item_1"

  - `operations.order_id` (number)
    Descrição da operação do lado da Xsolla.
    Example: 123456

  - `operations.platform` (string)
    Plataforma de publicação em que o usuário joga.
    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)
    O identificador de usuário exclusivo na plataforma.
    Example: "d.user"

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Código de erro.
    Example: 1102

  - `errorMessage` (string)
    Mensagem de erro.
    Example: "[0401-1102]: Unprocessable Entity. The property sku is required"

  - `statusCode` (integer)
    Example: 422