# 쿠폰 보상 얻기

코드별로 쿠폰 보상을 받습니다.
사용자가 여러 아이템 중 하나를 보너스로 선택할 수 있도록 허용할 때 사용할 수 있습니다.
쿠폰에 게임이 보너스로 포함되어 있는 경우('type=unit') 일반적으로 DRM을 선택합니다.

Endpoint: GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.
    Example: 44056

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

## Response 200 fields (application/json):

  - `bonus` (array)

  - `bonus.item` (object)

  - `bonus.item.bundle_type` (string)
    번들 유형입니다. 아이템 유형이 번들인 경우 반환됩니다.
    Enum: "standard", "virtual_currency_package"

  - `bonus.item.content` (array)

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

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

  - `bonus.item.name` (object)
    아이템 이름입니다.
    Example: {"en":"Game name"}

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

  - `bonus.item.type` (string)
    아이템의 유형: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `bonus.item.unit_items` (array)
    아이템에 단위 유형이 있으면 해당 단위의 모든 아이템을 포함합니다. 대부분의 경우 사용자는 그 중 하나를 쿠폰 보너스로 선택해야 합니다.

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

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

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

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

  - `bonus.item.unit_items.type` (string)
    아이템의 유형: game_key.
    Example: "game_key"

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

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

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

  - `is_selectable` (boolean)
    true인 경우 사용자는 쿠폰을 사용하기 전에 보너스를 선택해야 합니다.

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1501

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

  - `statusCode` (integer)
    Example: 401

## Response 403 fields (application/json):

  - `errorCode` (integer)

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

  - `statusCode` (integer)
    Example: 403

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

## Response 404 fields (application/json):

  - `errorCode` (integer)
    Example: 4001

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

  - `statusCode` (integer)
    Example: 404