按购买项向用户发放商品

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

[{"purchase": {"amount": "3.5",
"comment": "xsolla",
"currency": "USD",
"custom_parameters": [{"user_device_info": {"engine_version": "Unity 2020.2.0b5",
"os": "windows"
},
"user_public_id": {"nickname": "player1"
}
},
{"comment": "xsolla",
"custom_parameters": {"content_creator_rewards": [{"content_creator": {"id": "cc1"
},
"reward": {"amount": "10.00",
"currency": "USD"
}
},
{"content_creator": {"id": "cc2"
},
"reward": {"amount": "15.00",
"currency": "RUB"
}
}
]
},
"items": [{"quantity": 5,
"sku": "panda_sdk3"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"purchase": {"amount": "3.5",
"currency": "USD",
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000001"
},
"user": {"id": "83857636-65b4-11e8-9ccb-42010a8a001c"
}
}
],
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000000",
"items": [{"quantity": 5,
"sku": "panda_sdk"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"user": {"id": "672c91cd-65db-4b6e-ad68-6e93b21249d8"
}
}
}
]

Response samples

application/json

{"count": 2,
"operations": [{"amount": "2.99",
"comment": "Quest completed",
"currency": "USD",
"custom_parameters": {"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": "player2"
}
}
]
},
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 5,
"sku": "boots_1"
},
{"quantity": 3,
"sku": "crystal_pack_1"
}
],
"order_id": 123456,
"platform": "xbox_live",
"user_id": "0125760a-6810-11e9-84c0-42010aa80029"
},
{"amount": "2.99",
"comment": "Daily reward",
"currency": "USD",
"custom_parameters": null,
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 2,
"sku": "helmet_1"
},
{"quantity": 3,
"sku": "minigun_1"
}
],
"order_id": 123457,
"platform": "xbox_live",
"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14"
}
]
}