Xsolla-logo

購入したアイテムをユーザーに付与する

post/v2/project/{project_id}/inventory/purchase

指定されたユーザーインベントリに、指定された購入アイテムを追加します。

注意

一度に処理できる操作は最大50個です。この制限を超える操作は無視されます。
SecuritybasicAuth
Request
path Parameters
project_id
required
integer
Default: 44056

プロジェクトID。

Request Body schema: application/json
Array
required
object
id
string
Default: "d342dad2-9d59-11e9-a384-42010aa8003f"

プラットフォーム上でユニークなユーザー識別子。

required
Array of objects non-empty
Array (non-empty)
sku
required
string
Default: "booster_mega_1"

アイテムクラス識別子。SKUには、英小文字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

quantity
required
number
Default: 1

このクラスのアイテムが付与されるために必要な数。

required
object
amount
required
string
Default: "2.99"

控除前の購入金額。

currency
required
string
Default: "USD"

ISO 4217に基づく通貨を購入します。

external_purchase_id
required
string
Default: "10-534-35"

購入したプラットフォームからの購入インボイス識別子。

external_purchase_date
required
string
Default: "2020-01-01T05:00:00+05:00"

ISO 8601に基づく購入日。

comment
string [ 1 .. 255 ] characters
Default: "Monthly challenge rewards"

操作説明。例：「毎月のチャレンジリワード」。

object [ 1 .. 200 ] properties

プロジェクト特有のパラメータ。

additional property
Array of arrays or object or string or integer or null or number or boolean
One of:
arrays
platform
string
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"
Responses
200

ユーザーの購入に成功しました。

422

処理不可能なエンティティー。

Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "count": 2,
  • "operations": [
    ]
}