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