# Benutzern gekaufte Artikel gewähren

Fügt die angegebenen, gekauften Artikel dem angegebenen Benutzerinventaren hinzu.

AchtungEs können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert.

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

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID.

## Request fields (application/json):

  - `comment` (string)
    Vorgangsbeschreibung. Zum Beispiel: „Belohnungen für monatliche Herausforderung“.

  - `custom_parameters` (object)
    Projektspezifische Parameter.
    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)
    Anzahl der Artikel dieser Klasse, die gewährt werden müssen.

  - `items.sku` (string, required)
    Artikelklassenkennung. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

  - `platform` (string)
    Publishing-Plattform, auf der der Benutzer spielt.
    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)
    Kaufbetrag vor Abzügen.

  - `purchase.currency` (string, required)
    Kaufwährung gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.external_purchase_date` (string, required)
    Kaufdatum gemäß ISO 8601.

  - `purchase.external_purchase_id` (string, required)
    Rechnungskennung der Plattform, auf der der Kauf getätigt wurde.

  - `user` (object, required)

  - `user.id` (string)
    Die eindeutige Benutzerkennung auf der Plattform.

## Response 200 fields (application/json):

  - `count` (integer)
    Example: 10

  - `operations` (array)

  - `operations.amount` (string)
    Kaufbetrag vor Abzügen.
    Example: "2.99"

  - `operations.comment` (string)
    Vorgangsbeschreibung. Zum Beispiel: „Belohnungen für monatliche Herausforderung“.
    Example: "Montly challange rewards"

  - `operations.currency` (string)
    Kaufwährung gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `operations.custom_parameters` (object)
    Projektspezifische Parameter.
    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)
    Kaufdatum gemäß ISO 8601.
    Example: "2020-01-01T05:00:00+05:00"

  - `operations.external_purchase_id` (string)
    Rechnungskennung der Plattform, auf der der Kauf getätigt wurde.
    Example: "10-534-35"

  - `operations.items` (array)

  - `operations.items.quantity` (integer)
    Anzahl der Artikel dieser Klasse, die gewährt werden müssen.
    Example: 1

  - `operations.items.sku` (string)
    Artikelklassenkennung. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "com.xsolla.item_1"

  - `operations.order_id` (number)
    Vorgangsbeschreibung aufseiten von Xsolla.
    Example: 123456

  - `operations.platform` (string)
    Publishing-Plattform, auf der der Benutzer spielt.
    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)
    Die eindeutige Benutzerkennung auf der Plattform.
    Example: "d.user"

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Fehlercode.
    Example: 1102

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

  - `statusCode` (integer)
    Example: 422