# Octroyer des objets à des utilisateurs par achats

Ajoute des objets spécifiques aux inventaires des utilisateurs spécifiques en fonction de leurs achats.

AttentionSeules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projet.

## Request fields (application/json):

  - `comment` (string)
    Description de l'opération. Par exemple : « Récompenses mensuelles. »

  - `custom_parameters` (object)
    Paramètres spécifiques au projet.
    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)
    Nombre d'objets de cette classe à octroyer.

  - `items.sku` (string, required)
    Identifiant de la classe de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.

  - `platform` (string)
    Plateforme de publication sur laquelle l'utilisateur joue.
    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)
    Montant de l'achat avant toute déduction.

  - `purchase.currency` (string, required)
    Devise d'achat selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.external_purchase_date` (string, required)
    Date d'achat selon la norme ISO 8601.

  - `purchase.external_purchase_id` (string, required)
    Identifiant de facture de l'achat sur la plateforme sur laquelle l'achat a été effectué.

  - `user` (object, required)

  - `user.id` (string)
    Identifiant unique de l'utilisateur sur la plateforme.

## Response 200 fields (application/json):

  - `count` (integer)
    Example: 10

  - `operations` (array)

  - `operations.amount` (string)
    Montant de l'achat avant toute déduction.
    Example: "2.99"

  - `operations.comment` (string)
    Description de l'opération. Par exemple : « Récompenses mensuelles. »
    Example: "Montly challange rewards"

  - `operations.currency` (string)
    Devise d'achat selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `operations.custom_parameters` (object)
    Paramètres spécifiques au projet.
    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)
    Date d'achat selon la norme ISO 8601.
    Example: "2020-01-01T05:00:00+05:00"

  - `operations.external_purchase_id` (string)
    Identifiant de facture de l'achat sur la plateforme sur laquelle l'achat a été effectué.
    Example: "10-534-35"

  - `operations.items` (array)

  - `operations.items.quantity` (integer)
    Nombre d'objets de cette classe à octroyer.
    Example: 1

  - `operations.items.sku` (string)
    Identifiant de la classe de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.
    Example: "com.xsolla.item_1"

  - `operations.order_id` (number)
    Description de l'opération côté Xsolla.
    Example: 123456

  - `operations.platform` (string)
    Plateforme de publication sur laquelle l'utilisateur joue.
    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)
    Identifiant unique de l'utilisateur sur la plateforme.
    Example: "d.user"

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Code d'erreur.
    Example: 1102

  - `errorMessage` (string)
    Message d'erreur.
    Example: "[0401-1102]: Unprocessable Entity. The property sku is required"

  - `statusCode` (integer)
    Example: 422