# 프로모션 코드 보상 가져오기

코드로 프로모션 코드 보상을 가져옵니다.
사용자가 여러 아이템 중 하나를 보너스로 선택할 수 있도록 사용할 수 있습니다.
일반적인 경우는 프로모션 코드에 게임이 보너스로 포함된 경우 DRM을 선택하는 것입니다 (type=unit). 


  참고
    이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
    이 토큰은 Authorization 헤더에 다음 형식으로 포함해야 합니다: Bearer <user_JWT>. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.

Endpoint: GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID. 이 매개 변수는 프로젝트 이름 옆의 관리자 페이지에서 또는 프로젝트 작업 시 브라우저 주소 표시줄에서 확인할 수 있습니다. URL 형식은 다음과 같습니다: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `promocode_code` (string, required)
    고유한 대/소문자 구분 코드입니다. 문자와 숫자를 포함합니다.
    Example: "SO6rew99j9"

## Response 200 fields (application/json):

  - `bonus` (array)

  - `bonus.item` (object)

  - `bonus.item.sku` (string)
    고유 아이템 ID입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.
    Example: "game_01"

  - `bonus.item.name` (string)
    아이템 이름입니다.
    Example: "Game name"

  - `bonus.item.type` (string)
    아이템 유형. 가능한 값:virtual_good - 가상 아이템virtual_currency - 가상 통화bundle - 번들unit - 게임 키 패키지
    Example: "unit"

  - `bonus.item.description` (string)
    아이템 설명입니다.
    Example: "Game description"

  - `bonus.item.image_url` (string)
    이미지 URL입니다.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `bonus.item.unit_items` (array)
    플랫폼별 게임 키 모음. 아이템 유형이 unit(bonus.item.type = 'unit')인 경우에만 사용됩니다. 게임 키 패키지에 플랫폼별 키가 포함되어 있는 경우, 사용자는 그중 하나를 보너스로 선택할 수 있습니다.

  - `bonus.item.unit_items.sku` (string)
    고유한 플랫폼별 게임 키 패키지 ID. 허용된 문자: a–z, A–Z, 0–9, 맞침표(.), 하이픈(-), 밑줄(_). bonus.item.​sku 및 bonus.item.unit_items.drm_sku 값을 결합합니다. 예를 들어, bonus.item.​sku = 'cool_game' 및 bonus.item.unit_items.drm_sku = 'steam'인 경우, 값은 cool_game_steam이 됩니다.
    Example: "cool_game_steam"

  - `bonus.item.unit_items.is_free` (boolean)

  - `bonus.item.unit_items.type` (string)
    아이템이 게임 키인지 여부를 나타냅니다.
    Enum: "game_key"

  - `bonus.item.unit_items.name` (string)
    게임 타이틀입니다.
    Example: "Awesome Game"

  - `bonus.item.unit_items.drm_name` (string)
    DRM 이름입니다.
    Example: "Steam"

  - `bonus.item.unit_items.drm_sku` (string)
    플랫폼별 게임 키를 나타내기 위해 접미사로 사용되는 고유한 DRM ID. 허용되는 문자: a–z, A–Z, 0–9, 맞침표(.), 하이픈(-), 밑줄(_).
    Example: "steam"

  - `bonus.quantity` (number)
    아이템 수량입니다.

  - `discount` (object,null)
    퍼센트 할인입니다.
이 퍼센트를 사용하여 계산한 값을 사용하여 장바구니 항목의 가격을 낮추어 계산한 다음 소수점 이하 2자리로 반올림합니다.

  - `discount.percent` (string)
    Example: "10.00"

  - `discounted_items` (array,null)
    프로모션 코드로 할인한 아이템의 목록입니다.

  - `discounted_items.sku` (string, required)
    아이템 SKU입니다.

  - `discounted_items.discount` (object, required)

  - `discounted_items.discount.percent` (string, required)
    퍼센트 할인입니다.

이 퍼센트를 사용하여 계산한 값을 사용하여
장바구니 아이템의 가격이 낮아지게 한 다음
소수점 이하 2자리로 반올림합니다.

  - `is_selectable` (boolean)
    true인 경우 사용자는 프로모션 코드를 사용하기 전에 보너스를 선택해야 합니다.

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1501

  - `errorMessage` (string)
    Example: "[0401-1501]: Authorization failed: Provide authorization"

## Response 403 fields (application/json):

  - `statusCode` (integer)
    Example: 403

  - `errorCode` (integer)

  - `errorMessage` (string)
    Example: "Authorization header not sent."

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    Example: 404

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-9807]: Enter valid promo code."