구매를 통해 사용자에게 아이템 부여하기

Digital Distribution Hub API

In-Game Store & Buy Button API

개요

API 정의 다운로드

사용자 특성

관리자

개인 맞춤형 카탈로그

번들

관리자

카탈로그

장바구니 및 결제

장바구니(클라이언트 측)

장바구니(서버측)

결제(클라이언트 측)

결제(서버 측)

주문

무료 아이템

일반

웹훅

선주문

판매자

카탈로그

공통 지역

게임 키

카탈로그

권한

관리자

플레이어 인벤토리

클라이언트

관리

post

구매를 통해 사용자에게 아이템 부여하기

교차 인벤토리

프로모션

일반

가상 아이템 및 인게임 재화

관리자

카탈로그

가상 결제

NFT 아이템

관리자

카탈로그

제한 사항

관리

REWARD CHAINS & VALUE POINTS

관리자

클라이언트

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

구매를 통해 사용자에게 아이템 부여하기

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