`는 사용자 토큰입니다. 이 토큰은 사용자를 식별하고 개인화된 데이터에 대한 액세스를 제공합니다. 또는 [결제 UI를 여는 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
2. **Simplified mode without Authorization header.** 이 모드는 미인증 사용자만 사용하며, [게임 키 판매](/ko/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)에만 적용할 수 있습니다. 토큰 대신 요청에 다음 헤더를 포함해야 합니다.
- 요청 ID와 `x-unauthorized-id`
- Base64로 인코딩된 사용자의 이메일 주소와 `x-user`
## 유용한 링크
- [상호작용 모델별 API 호출](https://developers.xsolla.com/ko/api/catalog/)
- [엔드포인트 유형](https://developers.xsolla.com/ko/api/catalog/)
- [오류 처리](https://developers.xsolla.com/ko/api/catalog/)
- [API 키](https://developers.xsolla.com/ko/api/catalog/)
# 핵심 엔티티 구조
모든 유형의 아이템(가상 아이템, 번들, 인게임 재화, 키)은 유사한 데이터 구조를 사용합니다. 기본 구조를 이해하면 API 작업이 간소화되고 문서를 더 쉽게 탐색할 수 있습니다.
참고
일부 호출에는 추가 입력란이 포함될 수 있지만 기본 구조는 변경되지 않습니다.
**식별**
- `merchant_id`- [관리자 페이지](https://publisher.xsolla.com/)의 회사 ID
- `project_id` - 관리자 페이지의 프로젝트 ID
- `sku` - 프로젝트 내의 고유한 아이템 SKU
**Store display**
- `name` - 아이템 이름
- `description` - 아이템 설명
- `image_url` - 이미지 URL
- `is_enabled` - 아이템 가용성
- `is_show_in_store` - 카탈로그에 아이템이 표시되는지 여부
카탈로그에서 아이템 가용성 관리에 대한 자세한 정보는 [문서](/ko/items-catalog/catalog-features/items-availability/)를 참조하세요.
**Organization**
- `type` - 아이템 유형, 예를 들어 가상 아이템(`virtual_item`) 또는 번들(`bundle`)
- `groups` - 아이템이 속한 그룹
- `order` - 카탈로그 내 디스플레이 순서
**판매 조건**
- `prices` - 실제 화폐 또는 인게임 재화로 된 가격
- `limits` - 구매 한도
- `periods` - 가용 기간
- `regions` - 지역 제한
**핵심 엔티티 구조 예시:**
```json
{
"attributes": [],
"bundle_type": "virtual_currency_package",
"content": [
{
"description": {
"en": "Main in-game currency"
},
"image_url": "https://.../image.png",
"name": {
"en": "Crystals",
"de": "Kristalle"
},
"quantity": 500,
"sku": "com.xsolla.crystal_2",
"type": "virtual_currency"
}
],
"description": {
"en": "Crystals x500"
},
"groups": [],
"image_url": "https://.../image.png",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {
"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"long_description": null,
"media_list": [],
"name": {
"en": "Medium crystal pack"
},
"order": 1,
"periods": [
{
"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [
{
"amount": 20,
"country_iso": "US",
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [],
"sku": "com.xsolla.crystal_pack_2",
"type": "bundle",
"vc_prices": []
}
```
# 기본 구매 흐름
엑솔라 API를 사용하면 아이템 카탈로그 검색, 장바구니 관리, 주문 생성 및 상태 추적을 포함한 인게임 스토어 로직을 구현할 수 있습니다. 통합 시나리오에 따라 API 호출은 **Admin**와 **Catalog** 하위 섹션으로 구분되며, 서로 다른 [인증 방식](/ko/api/catalog/section/authentication)을 사용합니다.
다음 예시는 아이템 생성부터 구매까지 스토어 설정 및 운영을 위한 기본 흐름을 보여줍니다.
## 아이템 및 그룹 생성(관리자)
가상 아이템, 번들, 인게임 재화와 같은 스토어의 아이템 카탈로그를 생성합니다.
예시 API 호출:
- [가상 아이템 생성](/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)
- [번들 생성](/ko/api/catalog/bundles-admin/admin-create-bundle)
- [인게임 재화 생성](/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)
## 프로모션, 체인 및 한도 설정(관리자)
할인, 보너스, 일일 보상 또는 혜택 체인과 같은 사용자 획득 및 수익화 도구를 구성합니다.
예시 API 호출:
- [보너스 프로모션 생성](/ko/api/liveops/promotions-bonuses/create-bonus-promotion)
- [일일 보상 생성](/ko/api/liveops/daily-chain-admin/admin-create-daily-chain)
- [고유 카탈로그 혜택 프로모션 생성](/ko/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)
## 아이템 정보 가져오기(클라이언트)
애플리케이션에서 아이템 디스플레이를 구성합니다.
알림
사용자 카탈로그를 구축하는 데 관리자 하위 섹션의 API 호출을 사용하지 마십시오. 이러한 API 호출에는
속도 제한이 있으며 사용자 트래픽을 위한 것이 아닙니다.
API 호출 예시:
- [가상 아이템 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items)
- [아이템 그룹 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-item-groups)
- [번들 목록 가져오기](/ko/api/catalog/bundles-catalog/get-bundle-list)
- [판매 가능한 아이템 목록 가져오기](/ko/api/catalog/common-catalog/get-sellable-items)
참고
기본적으로 카탈로그 API 호출은 요청 시점에 스토어에서 현재 사용 가능한 아이템을 반환합니다. 아직 사용 가능하지 않거나 더 이상 사용 가능하지 않은 아이템을 검색하려면 카탈로그 요청에 "show_inactive_time_limited_items": 1 매개 변수를 포함하십시오.
## 아이템 판매
다음 방법을 사용하여 아이템을 판매할 수 있습니다:
- 빠른 구매 - 하나의 SKU를 여러 번 판매합니다.
- 장바구니 구매 - 사용자가 장바구니에 아이템을 추가하고, 제거하고, 수량을 업데이트합니다.
아이템이 실제 돈 대신 인게임 재화로 구매된 경우, [인게임 재화로 구매한 특정 아이템으로 주문 생성](/ko/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency) API 호출을 사용하십시오. 결제 UI는 필요하지 않으며, API 호출이 실행될 때 청구가 처리됩니다.
무료 아이템 구매의 경우, [특정 무료 아이템으로 주문 생성](/ko/api/catalog/free-item/create-free-order-with-item) API 호출 또는 [무료 장바구니로 주문 생성](/ko/api/catalog/free-item/create-free-order) API 호출을 사용하십시오. 결제 UI는 필요하지 않으며, 주문은 즉시 done 상태로 설정됩니다.
### 빠른 구매
클라이언트 측 API 호출을 사용하여 [특정 아이템으로 주문 생성](/ko/api/catalog/payment-client-side/create-order-with-item)을 수행합니다. 호출은 결제 UI를 열기 위한 토큰을 반환합니다.
참고
할인 정보는 결제 UI에서만 사용자에게 제공됩니다. 프로모션 코드는 지원되지 않습니다.
### 장바구니 구매
장바구니 설정 및 구매는 클라이언트 또는 서버 측에서 수행할 수 있습니다.
**클라이언트에서 장바구니 설정 및 구매**
아이템 추가 및 제거 로직을 직접 구현하십시오. 장바구니 설정을 위한 API 호출 전에는 구매에 적용될 프로모션에 대한 정보를 알 수 없습니다. 이는 총 비용과 추가 보너스 아이템의 세부 사항을 알 수 없음을 의미합니다.
다음 장바구니 로직을 구현하십시오:
1. 플레이어가 장바구니를 채운 후, [아이템으로 장바구니 채우기](/ko/api/shop-builder/operation/cart-fill/) API 호출을 사용하십시오. 호출은 선택한 아이템에 대한 현재 정보를 반환합니다 (할인 전후 가격, 보너스 아이템).
2. 사용자 작업에 따라 장바구니 내용을 업데이트하십시오:
- 아이템을 추가하거나 아이템 수량을 변경하려면 [장바구니 ID로 장바구니 아이템 업데이트](/ko/api/shop-builder/operation/put-item-by-cart-id/) API 호출을 사용하십시오.
- 아이템을 제거하려면 [장바구니 ID로 장바구니 아이템 삭제](/ko/api/shop-builder/operation/delete-item-by-cart-id/) API 호출을 사용하십시오.
참고
현재 장바구니 상태를 얻으려면 현재 사용자의 장바구니 가져오기 API 호출을 사용하십시오.
3. [현재 장바구니의 모든 아이템으로 주문 생성](/ko/api/shop-builder/operation/create-order/) API 호출을 사용하십시오. 호출은 주문 ID와 결제 토큰을 반환합니다. 새로 생성된 주문은 기본적으로 new 상태로 설정됩니다.
**서버에서 장바구니 설정 및 구매**
이 설정 옵션은 장바구니 설정에 더 많은 시간이 걸릴 수 있습니다. 장바구니의 각 변경 사항은 API 호출을 동반해야 하기 때문입니다.
다음 장바구니 로직을 구현하십시오:
1. 플레이어가 장바구니를 채운 후, [아이템으로 장바구니 채우기](/ko/api/catalog/cart-server-side) API 호출을 사용하십시오. 호출은 선택한 아이템에 대한 현재 정보를 반환합니다(할인 전후 가격, 보너스 아이템).
2. [현재 장바구니의 모든 아이템으로 주문 생성](/ko/api/shop-builder/operation/create-order/) API 호출을 사용하십시오. 호출은 주문 ID와 결제 토큰을 반환합니다. 새로 생성된 주문은 기본적으로 new 상태로 설정됩니다.
## 결제 UI 열기
반환된 토큰을 사용하여 새 창에서 결제 UI를 엽니다. 결제 UI를 여는 다른 방법은 [문서](/ko/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui)에 설명되어 있습니다.
| 작업 | 엔드포인트 |
|:--------------------------------|:--------------------------------------------------------------------------|
| 프로덕션 환경에서 열기. | https://secure.xsolla.com/paystation4/?token={token} |
| 샌드박스 모드에서 열기. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |
참고
개발 및 테스트 중에는 샌드박스 모드를 사용하세요. 테스트 구매는 실제 계정에 청구되지 않습니다.
테스트 은행 카드를 사용할 수 있습니다.
첫 번째 실제 결제가 이루어진 후에는 엄격한 샌드박스 결제 정책이 적용됩니다. 샌드박스 모드에서의 결제는 [관리자 페이지 > 회사 설정 > 사용자](https://publisher.xsolla.com/0/settings/users)에 지정된 사용자에게만 가능합니다.
실제 통화로 인게임 재화와 아이템을 구매하려면 엑솔라와의 라이선스 계약을 체결해야 합니다. 이를 위해 [관리자 페이지](https://publisher.xsolla.com/)에서 **Agreements & Taxes > Agreements**으로 이동하여 계약 양식을 작성하고 확인을 기다리세요. 계약 검토에는 최대 3영업일이 소요될 수 있습니다.
샌드박스 모드를 활성화하거나 비활성화하려면 빠른 구매 및 장바구니 구매 요청에서 `sandbox` 매개 변수의 값을 변경하세요. 기본적으로 샌드박스 모드는 꺼져 있습니다.
가능한 주문 상태:
- `new` - 주문 생성됨
- `paid` - 결제 완료됨
- `done` - 아이템 전달됨
- `canceled` - 주문 취소됨
- `expired` -주문 만료됨
다음 방법 중 하나를 사용하여 주문 상태를 추적하세요:
- [서버에 구성된 웹훅](/ko/virtual-goods/own-ui/server-side-token-generation/set-up-order-tracking/#payments_integration_order_tracking)
- [짧은 폴링](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_short_polling)
- [WebSocket API](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_websocket_api)
## 유용한 링크
- 인증
- [상호작용 모델에 따른 API 호출](/ko/api/catalog/section/authentication)
- [결제 테스트](/ko/dev-resources/testing/general-info/#general_overview)
- [주문 상태 추적 설정](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?link=200-api#payments_integration_order_tracking)
- [웹훅](/ko/webhooks/overview)
- [속도 제한](/ko/api/login/rate-limits)
- [오류 처리](/ko/api/getting-started/#api_errors_handling)
- [API 키](/ko/api/getting-started/#api_keys_overview)
# 페이지 매김
대량의 레코드를 반환하는 API 호출(예: 카탈로그 작성 시)은 데이터를 페이지 단위로 반환합니다. 페이지 매김은 단일 API 응답에서 반환되는 항목 수를 제한하고 이후 페이지를 순차적으로 검색할 수 있는 메커니즘입니다.
반환되는 아이템 수를 제어하기 위해 다음 매개 변수를 사용하세요:
- `limit` - 페이지당 항목 수
- `offset` - 페이지의 첫 번째 항목의 인덱스(번호는 0부터 시작)
- `has_more` - 다른 페이지가 있는지 여부를 나타냄
- `total_items_count` - 총 항목 수
요청 예시:
```
GET /items?limit=20&offset=40
```
응답 예시:
```json
{
"items": [...],
"has_more": true,
"total_items_count": 135
}
```
응답이 `has_more = false`를 반환할 때까지 후속 요청을 보내는 것이 좋습니다.
# 날짜 및 시간 형식
날짜 및 시간 값은 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 형식으로 전달됩니다.
다음이 지원됩니다:
- UTC 오프셋
- 항목 표시 시간 제한이 없는 경우 `null` 값
- 일부 입력란에서 사용되는 [Unix 타임스탬프](https://www.unixtimestamp.com/)(초 단위)
형식: `YYYY-MM-DDTHH:MM:SS±HH:MM`
예시: `2026-03-16T10:00:00+03:00`
# 현지화
엑솔라는 항목 이름 및 설명과 같은 사용자 대상 입력란의 현지화를 지원합니다. 현지화된 값은 언어 코드를 키로 사용하는 개체로 전달됩니다. 지원되는 언어의 전체 목록은 [문서](/ko/doc/shop-builder/references/supported-languages/)에서 확인할 수 있습니다.
**Supported fields**
다음 매개 변수에 대해 현지화를 지정할 수 있습니다:
- `name`
- `description`
- `long_description`
**Locale format**
로케일 키는 다음 형식 중 하나로 지정할 수 있습니다:
- 두 글자 언어 코드: `en`, `ru`
- 다섯 글자 언어 코드: `en-US`, `ru-RU`, `de-DE`
**Examples**
두 글자 언어 코드 예시:
```json
{
"name": {
"en": "Starter Pack",
"ru": "Стартовый набор"
}
}
```
다섯 글자 언어 코드 예시:
```json
{
"description": {
"en-US": "Premium bundle",
"de-DE": "Premium-Paket"
}
}
```
# 오류 응답 형식
오류가 발생하면, API는 HTTP 상태와 JSON 응답 본문을 반환합니다. 스토어 관련 오류의 전체 목록은 [문서](/ko/dev-resources/references/errors/store-errors/)에서 확인할 수 있습니다.
**Response example:**
```json
{
"errorCode": 1102,
"errorMessage": "Validation error",
"statusCode": 422,
"transactionId": "c9e1a..."
}
```
- `errorCode` - 오류 코드.
- `errorMessage` - 짧은 오류 설명.
- `statusCode` - HTTP 응답 상태.
- `transactionId` - 요청 ID. 일부 경우에만 반환됩니다.
- `errorMessageExtended` - 요청 매개 변수와 같은 추가 오류 세부 정보. 일부 경우에만 반환됩니다.
**Extended response example:**
```json
{
"errorCode": 7001,
"errorMessage": "Chain not found",
"errorMessageExtended": {
"chain_id": "test_chain_id",
"project_id": "test_project_id",
"step_number": 2
},
"statusCode": 404
}
```
**Common HTTP status codes**
- `400` - 잘못된 요청
- `401` - 인증 오류
- `403` - 권한 부족
- `404` - 리소스를 찾을 수 없음
- `422` - 유효성 검사 오류
- `429` - 속도 제한 초과
**Recommendations**
- HTTP 상태와 응답 본문을 함께 처리하세요.
- `errorCode`를 사용하여 애플리케이션 로직과 관련된 오류를 처리하세요.
- `transactionId`를 사용하여 오류 분석 시 요청을 더 빠르게 식별하세요.
Version: 2.0.0
## Servers
```
https://store.xsolla.com/api
```
## Security
### basicAuth
서버 측 호출은 `basicAuth` 인증 체계를 사용합니다. API에 대한 모든 요청은 `Authorization: Basic ` 헤더를 포함해야 하며, 여기에서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `project_id:api_key` 쌍입니다.
필요한 경우 `project_id` 대신 `merchant_id`를 사용할 수 있습니다. 기능에는 영향을 미치지 않습니다.
다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.
* `merchant_id`는 다음 위치에 표시됩니다:
* **Company settings > Company** 섹션
* 관리자 페이지의 모든 페이지에서 브라우저 주소 표시줄의 URL. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com/`.
* `api_key`는 생성 시 관리자 페이지에서 한 번만 표시되며, 귀하의 측에서 저장해야 합니다. 새 키는 다음 섹션에서 생성할 수 있습니다:
* [Company settings > API keys](https://publisher.xsolla.com/0/settings/api_key)
* [Project settings > API keys](https://publisher.xsolla.com/0/projects/0/edit/api_key)
{% html name="div" attrs={"class": "notice"} %}
**Notice**
필수 API 호출에 `project_id` 경로 매개 변수가 포함되어 있지 않으면, 모든 회사 프로젝트에 대해 유효한 API 키를 사용하여 인증하세요.
{% /html %}
* `project_id`는 다음 위치에 표시됩니다:
* 프로젝트 이름 옆의 관리자 페이지.
* 관리자 페이지에서 프로젝트 작업 시 브라우저 주소 표시줄의 URL. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com//projects/`.
API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.
Type: http
Scheme: basic
### XsollaLoginUserJWT
클라이언트 측 호출은 `XsollaLoginUserJWT` 인증 체계를 사용합니다. 요청에는 Bearer `` 형식으로 `Authorization` 헤더에 사용자의 JWT를 포함해야 합니다. 이 토큰은 사용자를 식별하고 개인화된 데이터에 대한 액세스 를 제공합니다. 토큰 생성 방법에 대한 자세한 내용은 [엑솔라 로그인 API 문서](/ko/api/login/authentication-schemes#getting-user-token)를 참조하십시오.
또는 [결제 UI를 여는 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
Type: http
Scheme: bearer
Bearer Format: JWT
### AuthForCart
이 `AuthForCart` 인증 체계는 장바구니 구매에 사용되며 두 가지 모드를 지원합니다.
1. 사용자의 JWT로 인증합니다. 토큰은 인증 헤더에 `Authorization: Bearer ` 형식으로 전달되며, ``는 사용자 토큰입니다. 이 토큰은 사용자를 식별하고 사용자 맞춤 설정된 데이터에 대한 액세스를 제공합니다.
또는 [결제 UI를 여는 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
2. `Authorization` 헤더가 없는 간소화된 모드. 이 모드는 인증되지 않은 사용자만 사용하며, [게임 키 판매](/ko/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)에만 적용할 수 있습니다. 토큰 대신 요청에 다음 헤더를 포함해야 합니다.
* 요청 ID와 `x-unauthorized-id`
* Base64로 인코딩된 사용자의 이메일 주소와 `x-user`.
Type: http
Scheme: bearer
### basicMerchantAuth
서버 측 호출은 `basicMerchantAuth` 인증 체계를 사용합니다. 모든 API 요청에는 `Authorization: Basic ` 헤더가 포함되어야 하며, 여기서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `merchant_id:api_key` 쌍입니다.
다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.
* `merchant_id`는 다음 위치에 표시됩니다:
* **Company settings > Company** 섹션
* 관리자 페이지의 모든 페이지에서 브라우저 주소 표시줄의 URL에 표시됩니다. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com/`
* `api_key`는 생성 시 관리자 페이지에 한 번만 표시되며, 귀하의 측에서 저장해야 합니다. 새로운 키는 [Company settings > API keys](https://publisher.xsolla.com/0/settings/api_key) 섹션에서 생성할 수 있습니다.
API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.
Type: http
Scheme: basic
## Download OpenAPI description
[LiveOps API](https://developers.xsolla.com/_bundle/@l10n/ko/api/liveops/index.yaml)
## 일반 API 호출
이 하위 섹션에서 API 메소드를 호출하여 다양한 프로모션 유형을 관리할 수 있습니다.
### 모든 프로모션 목록 가져오기
- [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/ko/api/liveops/promotions-common/get-promotion-list.md): 프로젝트의 프로모션 목록을 가져옵니다.
### 프로모션 활성화
- [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/ko/api/liveops/promotions-common/activate-promotion.md): 프로모션을 활성화합니다.
### 프로모션 비활성화
- [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/ko/api/liveops/promotions-common/deactivate-promotion.md): 프로모션을 비활성화합니다.
### 코드로 교환 가능한 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/ko/api/liveops/promotions-common/get-redeemable-promotion-by-code.md): 프로모션 코드 또는 쿠폰 코드로 프로모션을 가져옵니다.
### 프로모션 코드 확인
- [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/ko/api/liveops/promotions-common/verify-promotion-code.md): 코드가 프로모션 코드인지 쿠폰 코드인지, 사용자가 이를 적용할 수 있는지를 결정합니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 쿠폰
쿠폰 프로모션을 구성하고 관리하려면 이 하위 섹션의 API 메소드를 호출합니다.
참고
쿠폰에 대한 자세한 정보는 참조 문서를 참조하십시오.
### 쿠폰 코드 사용
- [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/redeem-coupon.md): 쿠폰 코드를 사용합니다. 쿠폰이 사용되면 사용자는 보너스를 받습니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 쿠폰 보상 얻기
- [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupon-rewards-by-code.md): 코드로 쿠폰 보상을 가져옵니다.
사용자가 여러 아이템 중 하나를 보너스로 선택할 수 있도록 사용할 수 있습니다.
일반적인 경우는 쿠폰에 게임이 보너스로 포함된 경우 DRM을 선택하는 것입니다 (type=unit).
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 쿠폰 프로모션 생성하기
- [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/admin-create-coupon.md): 쿠폰 프로모션을 생성합니다.
### 쿠폰 프로모션 목록 가져오기
- [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupons.md): 프로젝트의 쿠폰 프로모션 목록을 가져옵니다.
### 쿠폰 프로모션 업데이트
- [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/update-coupon-promotion.md): 쿠폰 프로모션을 업데이트합니다.
### 쿠폰 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupon.md): 지정된 쿠폰 프로모션을 가져옵니다.
### 쿠폰 프로모션 삭제
- [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/delete-coupon-promotion.md): 쿠폰 프로모션을 삭제합니다. 삭제된 프로모션:
* 프로젝트에 설정된 프로모션 목록에서 사라집니다.
* 더 이상 아이템 카탈로그에 적용되지 않습니다. 사용자는 이 프로모션으로 보너스 아이템을 얻을 수 없습니다.
삭제한 후에는 프로모션을 복원할 수 없습니다.
삭제된 프로모션의 쿠폰 코드는 기존 프로모션에 추가할 수 있습니다.
### 쿠폰 프로모션 활성화
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/activate-coupon.md): 쿠폰 프로모션을 활성화합니다.
생성된 쿠폰 프로모션은 기본적으로 비활성화되어 있습니다.
프로모션을 활성화할 때까지 사용할 수 없습니다.
이 엔드포인트를 사용하여 쿠폰 프로모션을 활성화합니다.
### 쿠폰 프로모션 비활성화
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/deactivate-coupon.md): 쿠폰 프로모션을 비활성화합니다.
생성된 쿠폰 프로모션은 기본적으로 비활성화되어 있습니다.
프로모션을 활성화할 때까지 사용할 수 없습니다.
이 엔드포인트를 사용하여 쿠폰 프로모션을 비활성화합니다.
### 쿠폰 코드 생성하기
- [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/create-coupon-code.md): 쿠폰 코드를 생성합니다.
### 쿠폰 코드 가져오기
- [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupon-codes.md): 쿠폰 코드를 가져옵니다.
응답에는 프로모션의 총 코드 수(total_count)와 현재 페이지의 코드(codes)가 포함됩니다. 다음 페이지를 불러오려면 모든 코드를 모두 가져올 때까지 offset 값을 limit 값만큼 늘리십시오(예: “offset”: 100, 그 다음 “offset”: 200).
대부분의 경우 “limit”: 100 또는 “limit”: 1000으로 충분합니다. “limit”: 10000과 같은 더 큰 값은 일회성 대량 내보내기 용도로만 사용하고, 반드시 필요한 경우가 아니면 “limit”: 50000의 사용은 피하십시오.
### 쿠폰 코드 생성하기
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/generate-coupon-codes.md): 쿠폰 코드를 생성합니다.
코드 생성에 관한 지침:
* 프로모션당 코드 총 수량에 대한 상한은 없으나, 각 요청당 코드 수는 50,000개로 제한됩니다. 이 수량을 초과하는 요청은 422 Unprocessable Entity 오류가 반환됩니다. 50,000개 이상의 코드가 필요한 경우, 여러 번에 걸쳐 요청을 보내주십시오.
* 안정성을 높이기 위해, 요청당 최대 10,000개까지 소량씩 코드를 생성하는 것이 권장합니다. 예를 들어, 100,000개의 코드를 생성하려면 "count": 50000을 지정하여 2번의 요청을 보내는 대신, "count": 10000을 지정하여 10번의 요청을 보내십시오. 각 요청에 대한 성공 응답을 받은 후에 다음 요청을 보내십시오.
* 초당 15건의 요청으로 설정된 요청 제한에 유의하시기 바랍니다. 대량의 요청 생성 시 요청 제한을 초과하여 429 오류가 발생하지 않도록 요청을 순차적으로 전송하십시오.
* 코드 목록을 가져오려면 쿠폰 코드 가져오기 메서드를 호출하세요.
| 매개 변수 | 값 |
|---|---|
| 요청당 최소 코드 수. | 1 |
| 요청당 허용되는 최대 코드 수. 가능한 한 가장 큰 단일 배치 처리가 필요한 경우에만 사용하십시오. | 50,000 |
| 요청당 권장 코드 수. | 최대 10,000개까지입니다. 더 많이 생성해야 하는 경우, 순차적으로 여러 번 요청을 보내주십시오. |
### 지정된 사용자의 쿠폰 제한 가져오기
- [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupon-user-limit.md): 지정된 사용자가 쿠폰을 사용할 수 있는 남은 횟수를 가져옵니다.
사용자 제한 API를 사용하면 사용자가 쿠폰을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 관리 섹션으로 이동합니다.
* 쿠폰
### 고유 쿠폰 코드 제한 사항 가져오기
- [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-coupons/get-coupon-code-limit.md): 코드를 사용할 수 있는 남은 횟수를 가져옵니다. 코드를 필터링하려면 codes 쿼리 매개 변수를 사용합니다.
코드 제한 자체를 구성하려면 관리자 섹션으로 이동합니다.
* 쿠폰
## 프로모션 코드
이 하위 섹션의 API 메소드를 호출하여 프로모션 코드 프로모션을 구성하고 관리합니다.
참고
프로모션 코드에 대한 자세한 정보는 참조 문서를 참조하십시오.
### 프로모션 코드 사용
- [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/redeem-promo-code.md): 프로모션 코드 프로모션용 코드를 사용합니다.
프로모션 코드를 사용하면 사용자가 무료 아이템을 받게 되며, 장바구니 및/또는 특정 아이템의 가격이 할인됩니다.
### 장바구니에서 프로모션 코드 제거
- [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/remove-cart-promo-code.md): 장바구니에서 프로모션 코드를 제거합니다.
프로모션 코드를 제거하면 프로모션 코드에서 제공하는 보너스 및 할인 혜택 없이 카트에 있는 모든 아이템의 총 가격을 다시 계산합니다.
### 프로모션 코드 보상 가져오기
- [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promo-code-rewards-by-code.md): 코드로 프로모션 코드 보상을 가져옵니다.
사용자가 여러 아이템 중 하나를 보너스로 선택할 수 있도록 사용할 수 있습니다.
일반적인 경우는 프로모션 코드에 게임이 보너스로 포함된 경우 DRM을 선택하는 것입니다 (type=unit).
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 프로모션 코드 프로모션 생성하기
- [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/create-promo-code.md): 프로모션 코드 프로모션을 생성합니다.
### 프로모션 코드 프로모션의 목록 가져오기
- [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promo-codes.md): 프로젝트의 프로모션 코드 목록을 가져옵니다.
### 프로모션 코드 프로모션 업데이트
- [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/update-promo-code.md): 프로모션 코드 프로모션을 업데이트합니다.
### 프로모션 코드 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promo-code.md): 지정된 프로모션 코드 프로모션을 가져옵니다.
### 프로모션 코드 프로모션 삭제
- [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/delete-promo-code.md): 프로모션 코드 프로모션을 삭제합니다. 삭제된 프로모션:
* 프로젝트에 설정된 프로모션 목록에서 사라집니다.
* 아이템 카탈로그 및 장바구니에는 더 이상 적용되지 않습니다. 사용자는 이 프로모션을 사용하여 보너스 아이템을 얻거나 아이템을 구매할 수 없습니다.
삭제한 후에는 프로모션을 복원할 수 없습니다.
삭제된 프로모션의 프로모션 코드는 기존 프로모션에 추가할 수 있습니다.
### 프로모션 코드 프로모션 활성화
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/activate-promo-code.md): 프로모션 코드 프로모션을 활성화합니다.
생성된 프로모션 코드 프로모션은 기본적으로 비활성화되어 있습니다.
프로모션을 활성화할 때까지 사용할 수 없습니다.
이 엔드포인트를 사용하여 프로모션 코드 프로모션을 활성화합니다.
### 프로모션 코드 프로모션 비활성화
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/deactivate-promo-code.md): 프로모션 코드 프로모션을 비활성화합니다.
생성된 프로모션 코드 프로모션은 기본적으로 비활성화되어 있습니다.
프로모션을 활성화할 때까지 사용할 수 없습니다.
이 엔드포인트를 사용하여 프로모션 코드 프로모션을 비활성화합니다.
### 프로모션 코드 프로모션용 코드 생성하기
- [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/create-promo-code-code.md): 프로모션 코드 프로모션용 코드를 생성합니다.
### 프로모션 코드 프로모션용 코드 가져오기
- [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promocode-codes.md): 프로모션 코드 프로모션용 코드를 가져옵니다.
응답에는 프로모션의 총 코드 수(total_count)와 현재 페이지의 코드(codes)가 포함됩니다. 다음 페이지를 불러오려면 모든 코드를 모두 가져올 때까지 offset 값을 limit 값만큼 늘리십시오(예: “offset”: 100, 그 다음 “offset”: 200).
대부분의 경우 “limit”: 100 또는 “limit”: 1000으로 충분합니다. “limit”: 10000과 같은 더 큰 값은 일회성 대량 내보내기 용도로만 사용하고, 반드시 필요한 경우가 아니면 “limit”: 50000의 사용은 피하십시오.
### 프로모션 코드 프로모션용 코드 생성하기
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/generate-promo-code-codes.md): 프로모션 코드 프로모션용 코드를 생성합니다.
코드 생성에 관한 지침:
* 프로모션당 코드 총 수량에 대한 상한은 없으나, 각 요청당 코드 수는 50,000개로 제한됩니다. 이 수량을 초과하는 요청은 422 Unprocessable Entity 오류가 반환됩니다. 50,000개 이상의 코드가 필요한 경우, 여러 번에 걸쳐 요청을 보내주십시오.
* 안정성을 높이기 위해, 요청당 최대 10,000개까지 소량씩 코드를 생성하는 것이 권장합니다. 예를 들어, 100,000개의 코드를 생성하려면 "count": 50000을 지정하여 2번의 요청을 보내는 대신, "count": 10000을 지정하여 10번의 요청을 보내십시오. 각 요청에 대한 성공 응답을 받은 후에 다음 요청을 보내십시오.
* 초당 15건의 요청으로 설정된 요청 제한에 유의하시기 바랍니다. 대량의 요청 생성 시 요청 제한을 초과하여 429 오류가 발생하지 않도록 요청을 순차적으로 전송하십시오.
* 코드 목록을 가져오려면 프로모션 코드 목록 조회 메서드를 호출하십시오.
| 매개 변수 | 값 |
|---|---|
| 요청당 최소 코드 수. | 1 |
| 요청당 허용되는 최대 코드 수. 가능한 한 가장 큰 단일 배치 처리가 필요한 경우에만 사용하십시오. | 50,000 |
| 요청당 권장 코드 수. | 최대 10,000개까지입니다. 더 많이 생성해야 하는 경우, 순차적으로 여러 번 요청을 보내주십시오. |
### 지정된 사용자에 대한 프로모션 코드 제한 가져오기
- [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promo-code-user-limit.md): 지정된 사용자가 프로모션 코드를 사용할 수 있는 남은 횟수를 가져옵니다.
사용자 제한 API를 사용하면 사용자가 프로모션 코드를 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 관리 섹션으로 이동합니다.
* 프로모션 코드
### 코드에 대한 프로모션 코드 제한 가져오기
- [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-promo-codes/get-promo-code-code-limit.md): 코드를 사용할 수 있는 남은 횟수를 가져옵니다. 코드를 필터링하려면 codes 쿼리 매개 변수를 사용합니다.
코드 제한 자체를 구성하려면 관리자 섹션으로 이동합니다.
* 프로모션 코드
## 고유 카탈로그 혜택
고유 카탈로그 혜택을 구성하고 관리하려면 이 하위 섹션의 API 메소드를 호출합니다.
참고
고유 카탈로그 혜택에 대한 자세한 정보는 참조 문서를 참조하십시오.
### 고유 카탈로그 혜택 프로모션 생성
- [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): 고유 카탈로그 혜택 프로모션을 생성합니다.
### 고유 카탈로그 혜택 프로모션 목록 가져오기
- [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offers.md): 프로젝트의 고유 카탈로그 혜택 프로모션 목록을 가져옵니다.
### 고유 카탈로그 혜택 프로모션 업데이트
- [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): 고유 카탈로그 혜택 프로모션을 업데이트합니다.
### 고유 카탈로그 혜택 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer.md): 지정된 고유 카탈로그 혜택 프로모션을 가져옵니다.
### 고유 카탈로그 혜택 프로모션 삭제
- [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): 고유한 카탈로그 제안 프로모션을 삭제합니다. 삭제된 프로모션:
* 프로젝트에 설정된 프로모션 목록에서 사라집니다.
* 아이템 카탈로그 및 장바구니에는 더 이상 적용되지 않습니다. 사용자는 이 프로모션으로 상품을 구매할 수 없습니다.
삭제한 후에는 프로모션을 복원할 수 없습니다.
### 고유 카탈로그 혜택 프로모션 활성화
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): 고유 카탈로그 혜택 프로모션을 활성화합니다.
생성된 고유 카탈로그 혜택 프로모션은 기본적으로 비활성화되어 있습니다.
혜택을 활성화해야 사용할 수 있습니다.
이 엔드포인트를 사용하면 쿠폰 프로모션을 사용할 수 있게 설정하거나 활성화할 수 있습니다.
### 고유 카탈로그 혜택 프로모션 비활성화
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): 고유 카탈로그 혜택 프로모션을 비활성화합니다.
생성된 고유 카탈로그 혜택 프로모션은 기본적으로 비활성화되어 있습니다.
혜택을 활성화해야 사용할 수 있습니다.
이 엔드포인트를 사용하면 쿠폰 프로모션을 사용할 수 없게 설정하거나 비활성화할 수 있습니다.
### 고유 카탈로그 혜택 코드 생성
- [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): 고유 카탈로그 혜택 코드를 생성합니다.
### 고유 카탈로그 혜택 코드 가져오기
- [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): 고유 카탈로그 혜택 코드를 가져옵니다.
### 고유 카탈로그 혜택 코드 생성
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/ko/api/liveops/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): 고유 카탈로그 혜택 코드를 생성합니다.
## 할인
할인 프로모션을 구성하고 관리하려면 이 하위 섹션의 API 메소드를 호출합니다.
참고
할인에 대한 자세한 정보는 참조 문서를 참조하십시오.
### 아이템에 대한 할인 프로모션 생성하기
- [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ko/api/liveops/promotions-discounts/create-item-promotion.md): 아이템에 대한 할인 프로모션을 가져옵니다.
프로모션은 아이템에 대한 할인(%) 혜택을 제공합니다.
지정된 아이템의 모든 가격에 할인이 적용됩니다.
### 아이템 프로모션 목록 가져오기
- [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ko/api/liveops/promotions-discounts/get-item-promotion-list.md): 프로젝트의 아이템 프로모션 목록을 가져옵니다.
프로모션은 아이템에 대한 할인(%) 혜택을 제공합니다.
지정된 아이템의 모든 가격에 할인이 적용됩니다.
### 아이템 프로모션 업데이트
- [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ko/api/liveops/promotions-discounts/update-item-promotion.md): 프로모션을 업데이트합니다.
참고이전 데이터를 새 데이터로 교체합니다. 일부 프로모션만 업데이트하려면 요청 시 필요한 모든 데이터도 전송해야 합니다.
프로모션은 아이템에 대한 할인(%) 혜택을 제공합니다.
지정된 아이템의 모든 가격에 할인이 적용됩니다.
### 아이템 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ko/api/liveops/promotions-discounts/get-item-promotion.md): 특정 아이템에 적용한 프로모션을 가져옵니다.
프로모션은 아이템에 대한 할인(%) 혜택을 제공합니다.
지정된 아이템의 모든 가격에 할인이 적용됩니다.
### 아이템 프로모션 삭제
- [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ko/api/liveops/promotions-discounts/delete-item-promotion.md): 할인 프로모션을 삭제합니다. 삭제된 프로모션:
* 프로젝트에 설정된 프로모션 목록에서 사라집니다.
* 아이템 카탈로그 및 장바구니에는 더 이상 적용되지 않습니다. 사용자는 이 프로모션으로 상품을 구매할 수 없습니다.
삭제한 후에는 프로모션을 복원할 수 없습니다.
## 보너스
보너스 프로모션을 구성하고 관리하려면 이 하위 섹션의 API 메소드를 호출합니다.
참고
보너스에 대한 자세한 정보는 참조 문서를 참조하십시오.
### 보너스 프로모션 생성하기
- [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ko/api/liveops/promotions-bonuses/create-bonus-promotion.md): 보너스 프로모션을 생성합니다.
프로모션은 사용자가 구매한 구매 항목에 무료 보너스 아이템을 추가합니다.
프로모션은 프로젝트 내의 모든 구매 또는 특정 아이템을 포함하는 구매에 적용할 수 있습니다.
### 보너스 프로모션 목록 가져오기
- [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ko/api/liveops/promotions-bonuses/get-bonus-promotion-list.md): 프로젝트에 속한 보너스 프로모션 목록을 가져옵니다.
프로모션은 사용자가 구매한 구매 항목에 무료 보너스 아이템을 추가합니다.
프로모션은 프로젝트 내의 모든 구매 또는 특정 아이템을 포함하는 구매에 적용할 수 있습니다.
### 보너스 프로모션 업데이트
- [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ko/api/liveops/promotions-bonuses/update-bonus-promotion.md): 프로모션을 업데이트합니다.
참고이전 데이터를 새 데이터로 교체합니다. 일부 프로모션만 업데이트하려면 요청 시 필요한 모든 데이터도 전송해야 합니다.
프로모션은 사용자가 구매한 구매 항목에 무료 보너스 아이템을 추가합니다.
프로모션은 프로젝트 내의 모든 구매 또는 특정 아이템을 포함하는 구매에 적용할 수 있습니다.
### 보너스 프로모션 가져오기
- [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ko/api/liveops/promotions-bonuses/get-bonus-promotion.md): 보너스 프로모션을 가져옵니다.
프로모션은 사용자가 구매한 구매 항목에 무료 보너스 아이템을 추가합니다.
프로모션은 프로젝트 내의 모든 구매 또는 특정 아이템을 포함하는 구매에 적용할 수 있습니다.
### 보너스 프로모션 삭제
- [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ko/api/liveops/promotions-bonuses/delete-bonus-promotion.md): 보너스 프로모션을 삭제합니다. 삭제된 프로모션:
* 프로젝트에 설정된 프로모션 목록에서 사라집니다.
* 아이템 카탈로그 및 장바구니에는 더 이상 적용되지 않습니다. 사용자는 이 프로모션으로 보너스 아이템을 얻을 수 없습니다.
삭제한 후에는 프로모션을 복원할 수 없습니다.
## 개인 맞춤형 카탈로그
사용자 맞춤 설정을 통해 특정 인증된 사용자에게만 아이템 카탈로그를 표시하고 프로모션을 적용할 조건을 지정할 수 있습니다. 조건은 사용자 특성에 기반하여 정의되며, 특정 사용자에게 가장 관련성 있는 아이템과 프로모션을 제공할 수 있습니다.
다음과 같은 사용자 맞춤 설정 유형이 가능합니다:
* [엑솔라 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). 사용자 맞춤 설정 규칙과 로직은 엑솔라 측에서 구성되고 저장됩니다. 사용자 특성을 전달하면 엑솔라가 이를 사용하여 개인 설정된 카탈로그를 생성합니다.
* [파트너 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). 사용자 맞춤 설정 규칙과 로직을 파트너 측에서 구성하고 특정 사용자에 대한 최종 카탈로그 페이로드를 엑솔라에 전송합니다.
참고
하나의 사용자 맞춤 설정 유형만 사용할 수 있습니다. 변경하려면
지침을 따르십시오.
엑솔라 API를 사용하여 엑솔라 측에서 사용자 맞춤 설정을 구성하는 방법:
1. [가상 아이템 및 인게임 재화](/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [번들](/ko/api/catalog/bundles-admin/admin-create-bundle) 또는 [게임 키](/ko/api/catalog/game-keys-admin) 그룹의 **Admin** 하위 섹션의 API 호출을 사용하여 아이템을 생성합니다.
2. [엑솔라 로그인 API를 사용하여 사용자 특성을 설정](/ko/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes)하고, 게임 내에서 변경이 발생할 때마다 엑솔라에 데이터를 업데이트하여 동기화 상태를 유지합니다.
3. 아이템 또는 프로모션에 대한 사용자 맞춤 설정을 구성합니다:
* 아이템 카탈로그를 개인 설정하려면 [카탈로그 필터 규칙 생성](/ko/api/liveops/personalized-catalog/create-filter-rule) API 호출을 사용하여 카탈로그 표시 규칙을 정의합니다:
* [attribute_conditions](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) 목록에서 사용자 특성에 기반하여 아이템 가용성을 결정하는 조건을 지정합니다.
* [items](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) 목록에서 사용자의 특성이 지정된 조건과 일치할 경우 표시되어야 하는 아이템 목록을 제공합니다.
* 개인 설정한 프로모션을 구성하려면 [필요한 프로모션 유형에 대한 생성 및 업데이트 API 호출](/ko/api/liveops/promotions-discounts/create-item-promotion)을 사용합니다. [attribute_conditions](/ko/api/liveops/promotions-discounts/create-item-promotion) 목록에서 사용자 특성에 기반하여 프로모션 가용성을 결정하는 조건을 지정합니다.
4. 사용자 특성을 포함한 [사용자 JWT](/ko/api/login/getting-user-token?#getting-user-token)를 [카탈로그 검색 API 호출](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items)에 전달하여 개인 설정된 카탈로그를 받습니다.
**아이템 카탈로그에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**
**프로모션에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**
### 카탈로그 필터 규칙 목록 가져오기
- [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/get-filter-rules.md): 사용자 특성에 적용하는 모든 규칙을 가져옵니다.
### 카탈로그 필터 규칙 생성하기
- [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/create-filter-rule.md): 사용자 특성에 대한 규칙을 생성합니다.
### 클라이언트 측에서 검색하기 위한 모든 카탈로그 규칙을 가져옵니다
- [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/get-all-filter-rules.md): 클라이언트 측 검색을 위한 모든 카탈로그 규칙 목록을 가져옵니다.
주의규칙 ID, 이름 및 is_enabled만 반환합니다.
### 카탈로그 필터 규칙 가져오기
- [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/get-filter-rule-by-id.md): 사용자 특성에 적용하는 특정 규칙을 가져옵니다.
### 카탈로그 필터 규칙 업데이트
- [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/update-filter-rule-by-id.md): 사용자 특성에 적용하는 특정 규칙을 업데이트합니다. 기본 값을 지정되지 않은 특성에 사용됩니다(특성이 필수가 아닌 경우).
### 패치 카탈로그 필터 규칙
- [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/patch-filter-rule-by-id.md): 사용자 특성에 적용하는 특정 규칙을 업데이트합니다. 현재 값을 지정되지 않은 특성에 사용합니다.
### 카탈로그 필터 규칙 삭제
- [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ko/api/liveops/personalized-catalog/delete-filter-rule-by-id.md): 특정 규칙을 삭제합니다.
## 관리
### 지정된 사용자의 모든 프로모션 제한 설정 새로고침
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/reset-all-user-promotions-limit.md): 지정된 사용자에 대한 모든 프로모션의 모든 제한 설정을 새로고침하여 해당 프로모션을 다시 사용할 수 있도록 합니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
### 사용자에 대한 프로모션 제한 새로고침하기
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/reset-user-promotion-limit.md): 사용자가 이 프로모션을 다시 사용할 수 있도록 프로모션 제한을 새로고침합니다. user 매개변수가 null인 경우 이 호출은 모든 사용자에 대해 이 제한을 새로고침합니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
### 지정된 사용자의 프로모션 제한 설정 가져오기
- [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/get-user-promotion-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 프로모션 횟수를 가져옵니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
### 지정된 사용자의 프로모션 제한 설정 늘리기
- [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/add-user-promotion-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 프로모션 횟수를 늘립니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
### 지정된 사용자의 프로모션 제한 설정하기
- [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/set-user-promotion-limit.md): 프로모션 횟수를 늘리거나 줄인 후 지정된 사용자가 적용된 제한 설정 내에서 사용할 수 있는 남은 프로모션 횟수를 설정합니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
### 지정된 사용자의 프로모션 제한 설정 축소
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ko/api/liveops/user-limits-admin/remove-user-promotion-limit.md): 지정된 사용자가 적용된 제한 내에서 프로모션을 사용할 수 있는 남은 횟수를 줄입니다.
사용자 제한 API를 사용하면 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 사용자 제한 자체를 구성하려면 원하는 프로모션 유형의 관리 섹션으로 이동합니다.
* 할인 프로모션
* 보너스 프로모션
## 관리자
### 가치 포인트 목록 가져오기
- [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-get-value-points-list.md): 관리 대상 프로젝트에서 가치 포인트 목록을 가져옵니다.
### 가치 포인트 생성하기
- [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-create-value-points.md): 가치 포인트를 생성합니다.
### 가치 포인트 가져오기
- [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-get-value-point.md): 관리 대상 프로젝트에서 SKU별로 가치 포인트를 가져옵니다.
### 가치 포인트 업데이트
- [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-update-value-point.md): SKU로 식별되는 가치 포인트를 업데이트합니다.
### 가치 포인트 삭제
- [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-delete-value-point.md): SKU로 식별되는 가치 포인트를 삭제합니다.
### 가치 포인트가 있는 아이템 목록 가져오기
- [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): 관리 대상 프로젝트에서 가치 포인트가 있는 모든 아이템의 목록을 가져옵니다.
### 아이템에 대한 가치 포인트 설정
- [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): 하나 또는 여러 아이템에 SKU별로 가치 포인트를 할당합니다. 사용자가 이러한 아이템을 구매하면 가치 포인트를 받습니다.
이 PUT 요청은 프로젝트에서 이전에 설정한 모든 아이템의 가치 포인트를 덮어씁니다.
실수로 가치 포인트가 삭제되는 것을 방지하려면 각 PUT 요청에 모든 아이템과 해당 가치 포인트를 포함해야 합니다.
다른 아이템의 가치 포인트는 그대로 유지하면서 특정 아이템의 가치 포인트만 업데이트하려면 GET 요청을 사용하여 현재 가치 포인트 세트를 검색하고 원하는 아이템의 가치 포인트를 수정한 다음 수정된 가치 포인트 세트를 특정 아이템의 업데이트된 가치 포인트와 함께 다시 보내야 합니다.
### 아이템에 대한 가치 포인트를 부분적으로 업데이트
- [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): 아이템의 SKU에 의해 하나 이상의 아이템에 대한 가치 포인트 수를 부분적으로 업데이트합니다. 사용자는 지정된 아이템을 구매한 후 이러한 가치 포인트를 받게 됩니다.
가치 포인트 업데이트의 원칙:
* 아이템에 아직 가치 포인트가 없는 경우 amount 필드에 0이 아닌 값을 보내면 가치 포인트가 생성됩니다.
* 아이템에 이미 가치 포인트가 있는 경우 amount 필드에 0이 아닌 값을 보내면 가치 포인트가 업데이트됩니다.
* amount를 0으로 설정하면 해당 아이템에 대한 기존 가치 포인트가 삭제됩니다.
PUT 메서드(아이템에 대한 가치 포인트 설정)와 달리 이 PATCH 메서드는 프로젝트의 아이템에 대한 모든 기존 가치 포인트를 덮어쓰지 않고 지정된 아이템만 업데이트합니다.
단일 요청으로 최대 100개의 아이템을 업데이트할 수 있습니다. 중복 아이템 SKU는 동일한 요청에 포함될 수 없습니다.
### 아이템에서 가치 포인트 삭제하기
- [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): 모든 아이템에서 가치 포인트 보상을 제거합니다.
### 보상 체인 목록 가져오기
- [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-get-reward-chains.md): 보상 체인 목록을 가져옵니다.
주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 10개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 한계 및 오프셋 필드를 사용합니다.
### 보상 체인 생성하기
- [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-create-reward-chain.md): 보상 체인을 생성합니다.
### 보상 체인 가져오기
- [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-get-reward-chain.md): 특정 보상 체인을 가져옵니다.
### 보상 체인 업데이트
- [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-update-reward-chain.md): 특정 보상 체인을 업데이트합니다.
### 보상 체인 삭제
- [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-delete-reward-chain.md): 특정 보상 체인을 삭제합니다.
### 보상 체인 토글
- [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-toggle-reward-chain.md): 보상 체인을 활성화/비활성화합니다.
### 보상 체인 재설정
- [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/ko/api/liveops/reward-chain-value-points-admin/admin-reset-reward-chain.md): 리워드 체인에 속한 모든 사용자의 가치 포인트 잔액과 진행 상황을 재설정합니다.잔액은 가치 포인트 유형에 연동됩니다. 특정 리워드 체인에 연동되지 않습니다. 해당 가치 포인트가 다른 체인에서 사용 중인 경우, 해당 가치 포인트를 사용하는 모든 체인의 잔액이 재설정됩니다.재설정 후에는 리워드 체인의 유효 기간을 업데이트할 수 있으며, 사용자는 다시 진행 상황을 쌓아갈 수 있습니다.클랜 잔액은 구성원의 잔액을 모두 합산하여 계산됩니다. 따라서 재설정 후에는 클랜 잔액도 재설정됩니다. 이 요청은 되돌릴 수 없으며 프로젝트의 모든 사용자에게 적용됩니다.
참고
유효 기간 중에는 보상 체인을 재설정하면 안 됩니다. 재설정한 사용자는 보상을 받기 전에 적립된 가치 포인트를 잃을 수도 있습니다.
## 클라이언트
### 현재 사용자의 보상 체인 가져오기
- [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/ko/api/liveops/reward-chain-client/get-reward-chains-list.md): 클라이언트 엔드포인트. 현재 사용자의 보상 체인을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 현재 사용자의 가치 포인트 잔액 가져오기
- [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/ko/api/liveops/reward-chain-client/get-user-reward-chain-balance.md): 클라이언트 엔드포인트. 현재 사용자의 가치 포인트 잔액을 가져옵니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 단계 보상 청구하기
- [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/ko/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward.md): 클라이언트 엔드포인트. 보상 체인에서 현재 사용자의 단계 보상을 청구합니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 클랜 클라이언트
### 클랜 보상 체인에 가장 많이 기여한 상위 10명의 기여자를 뽑으세요
- [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/ko/api/liveops/clan-reward-chain-client/get-user-clan-top-contributors.md): 현재 사용자의 클랜 내 특정 보상 체인에 가장 많이 기여한 상위 10명의 기여자 목록을 가져옵니다. 사용자가 클랜에 속하지 않은 경우, 호출은 빈 목록을 반환합니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 현재 사용자의 클랜 업데이트
- [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/ko/api/liveops/clan-reward-chain-client/user-clan-update.md): 사용자 특성을 통해 현재 사용자의 클랜을 업데이트합니다. 이전 클랜에서 수령하지 않은 모든 보상 체인 보상을 청구하고 응답에 반환합니다. 사용자가 클랜에 속해 있었으나 이제 속하지 않은 경우, 클랜 포함이 취소됩니다. 사용자가 클랜을 변경한 경우, 클랜이 변경됩니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 관리자
### 일일 보상 목록 가져오기
- [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-get-daily-chains.md): 관리용 일일 보상 목록을 가져옵니다.
알림메서드는 항목의 페이지 매김된 목록을 반환합니다. 최대 및 기본 값은 응답당 50개 항목입니다. 목록에서 더 많은 항목을 가져오려면 limit 및 offset 매개변수를 사용하여 더 많은 페이지를 가져오십시오. 예를 들어, limit = 25 및 offset = 100으로 메서드를 호출하면, 전체 목록에서 101번째 항목부터 시작하여 25개의 항목을 반환합니다.
### 일일 보상 생성
- [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-create-daily-chain.md): 일일 보상을 생성합니다.
### 일일 보상 받기
- [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-get-daily-chain.md): 관리 작업을 수행하면 매일 특정 보상을 받습니다.
### 일일 보상을 업데이트합니다
- [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-update-daily-chain.md): 특정 일일 보상을 업데이트합니다.
### 일일 보상 삭제
- [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-delete-daily-chain.md): 특정 일일 보상을 삭제합니다.
### 일일 보상 토글 설정
- [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-toggle-daily-chain.md): 일일 보상을 활성화하거나 비활성화합니다.
### 일일 보상 초기화
- [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/ko/api/liveops/daily-chain-admin/admin-reset-daily-chain.md): 모든 사용자의 일일 보상 진행도를 초기화합니다. rolling 유형의 일일 보상에만 적용됩니다.
## 클라이언트
### 현재 사용자의 일일 보상 가져오기
- [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/ko/api/liveops/daily-chain-client/get-daily-chains-list.md): 클라이언트 엔드포인트. 현재 사용자의 일일 보상을 가져옵니다.
알림메서드는 항목의 페이지 매김된 목록을 반환합니다. 최대 및 기본 값은 응답당 50개 항목입니다. 목록에서 더 많은 항목을 가져오려면 limit 및 offset 매개변수를 사용하여 더 많은 페이지를 가져오십시오. 예를 들어, limit = 25 및 offset = 100으로 메서드를 호출하면, 전체 목록에서 101번째 항목부터 시작하여 25개의 항목을 반환합니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 현재 사용자의 ID로 일일 보상을 가져옵니다
- [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/ko/api/liveops/daily-chain-client/get-user-daily-chain-by-id.md): 클라이언트 엔드포인트. ID로 현재 사용자의 일일 보상을 가져옵니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 일일 단계 보상 청구하기
- [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ko/api/liveops/daily-chain-client/claim-user-daily-chain-step-reward.md): 클라이언트 엔드포인트. 현재 사용자의 일일 보상에서 단계 보상을 청구합니다. 모든 단계는 순차적으로만 청구할 수 있습니다. 누락된 단계의 보상은 가상 또는 실제 통화로, 또는 광고 시청으로 얻을 수 없습니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 관리자
### 혜택 체인 목록 가져오기
- [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-get-offer-chains.md): 관리할 혜택 체인 목록을 가져옵니다.
참고모든 프로젝트에서 단일 응답에 반환할 수 있는 아이템 수는 제한되어 있습니다. 기본값 및 최댓값은 응답당 10개 아이템입니다. 더 많은 데이터를 얻으려면 페이지 설정에서 limit 및 offset 쿼리 매개 변수를 사용해 주세요.
### 혜택 체인 생성
- [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-create-offer-chain.md): 혜택 체인을 생성합니다.
### 혜택 체인 가져오기
- [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-get-offer-chain.md): 관리할 특정 혜택 체인을 가져옵니다.
### 혜택 체인 업데이트
- [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-update-offer-chain.md): 특정 혜택 체인을 업데이트합니다.
### 혜택 체인 삭제
- [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-delete-offer-chain.md): 특정 혜택 체인을 삭제합니다.
삭제 후:사용자가 이미 받은 모든 리워드는 유지됩니다.완료되지 않은 단계는 사용할 수 없게 되며 해당 리워드는 더 이상 받을 수 없습니다.
혜택 체인 토글 전환 호출을 통해 혜택 체인을 비활성화하는 것과 달리, 삭제는 취소할 수 없으며 사용자 진행 상황은 보존되지 않습니다.
### 혜택 체인 토글 전환
- [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/ko/api/liveops/offer-chain-admin/admin-toggle-offer-chain.md): 혜택 체인을 활성화 또는 비활성화합니다.
혜택 체인을 비활성화하면 사용자는 일시적으로 액세스 권한을 잃지만 진행 상황은 유지됩니다.
혜택 체인을 다시 활성화하면 사용자는 중단한 단계부터 계속 진행할 수 있습니다.
## 클라이언트
### 현재 사용자의 혜택 체인 가져오기
- [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/ko/api/liveops/offer-chain-client/get-offer-chains-list.md): 현재 사용자의 혜택 체인을 가져옵니다.
참고모든 프로젝트에서 단일 응답에 반환할 수 있는 아이템 수는 제한되어 있습니다. 기본값 및 최대값은 응답당 30개 아이템입니다. 더 많은 데이터를 가져오려면 페이지 설정에서 limit 및 offset 쿼리 매개 변수를 사용하세요.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### ID로 현재 사용자의 혜택 체인 가져오기
- [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/ko/api/liveops/offer-chain-client/get-user-offer-chain-by-id.md): 현재 사용자의 혜택 체인을 혜택 체인의 ID로 가져옵니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 무료 혜택 체인 단계
- [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ko/api/liveops/offer-chain-client/claim-user-offer-chain-step-reward.md): 현재 사용자의 혜택 체인 단계 진행을 완료하고 관련 리워드를 지급합니다.
알림
혜택 체인의 무료 단계에서만 이 호출을 사용해 주세요.
실제 통화로 결제해야 하는 단계의 경우, 유료 오퍼 체인 단계 주문 생성 호출을 대신 사용해 주세요.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 유료 혜택 체인 단계 주문 생성
- [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ko/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): 지정된 유료 혜택 체인 단계와 연결된 아이템의 주문을 생성합니다. 생성된 주문은 new 주문 상태를 가져옵니다.
결제 UI를 새 창에서 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용합니다. 여기서 {token}은 수신한 토큰입니다.
테스트를 진행할 때에는 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.
알림
이 메서드는 클라이언트 측에서 사용해야 합니다. 사용자의 IP 주소는 통화 및 사용 가능한 결제 방법에 영향을 미치는 국가를 결정하는 데 사용됩니다. 서버 측에서 이 메서드를 사용하면 통화가 잘못 감지되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.
알림
유료 혜택 체인 단계에서만 이 호출을 사용하세요.
무료 단계의 경우 무료 혜택 체인 단계 신청 호출을 대신 사용해 주세요.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## payment-client-side
### 유료 혜택 체인 단계 주문 생성
- [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ko/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): 지정된 유료 혜택 체인 단계와 연결된 아이템의 주문을 생성합니다. 생성된 주문은 new 주문 상태를 가져옵니다.
결제 UI를 새 창에서 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용합니다. 여기서 {token}은 수신한 토큰입니다.
테스트를 진행할 때에는 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.
알림
이 메서드는 클라이언트 측에서 사용해야 합니다. 사용자의 IP 주소는 통화 및 사용 가능한 결제 방법에 영향을 미치는 국가를 결정하는 데 사용됩니다. 서버 측에서 이 메서드를 사용하면 통화가 잘못 감지되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.
알림
유료 혜택 체인 단계에서만 이 호출을 사용하세요.
무료 단계의 경우 무료 혜택 체인 단계 신청 호출을 대신 사용해 주세요.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 관리자
### 프로젝트의 상향 판매에 대한 정보 얻기
- [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ko/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin.md): 프로젝트의 상향 판매에 대한 정보(사용 여부, 상향 판매 유형 및 이 상향 판매의 일부인 아이템의 SKU 목록)를 검색합니다.
### 상향 판매 생성
- [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ko/api/liveops/upsell-admin/post-upsell.md): 프로젝트에 대한 상향 판매를 생성합니다.
Notice
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
Authorization 헤더에 Bearer <user_JWT> 형식으로 토큰을 포함하세요. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하세요.
### 상향 판매 업데이트
- [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ko/api/liveops/upsell-admin/put-upsell.md): 프로젝트에 대한 상향 판매를 업데이트합니다.
Notice
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
Authorization 헤더에 Bearer <user_JWT> 형식으로 토큰을 포함하세요. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하세요.
### 프로젝트의 상향 판매 활성화/비활성화
- [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/ko/api/liveops/upsell-admin/put-upsell-toggle-active-inactive.md): 프로젝트에서 상향 판매의 상태를 활성 또는 비활성으로 변경합니다.
Notice
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
Authorization 헤더에 Bearer <user_JWT> 형식으로 토큰을 포함하세요. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하세요.
## 클라이언트
### 프로젝트에서 상향 판매 아이템 목록 가져 오기
- [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/ko/api/liveops/upsell-client/get-upsell-for-project-client.md): 이미 설정된 경우 프로젝트의 상향 판매 아이템 목록을 가져옵니다.
참고
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.