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": [
    ]
}