# Obtener recompensas de códigos promocionales

Obtiene las recompensas de códigos promocionales por su código.
Pueden utilizarse para permitir a los usuarios elegir uno de varios artículos como bonificación.
El caso más habitual es elegir un DRM (gestión de derechos digitales) si el código promocional contiene un juego como bonificación (type=unit).

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

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
    Example: 44056

  - `promocode_code` (string, required)
    Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.
    Example: "SO6rew99j9"

## Response 200 fields (application/json):

  - `bonus` (array)

  - `bonus.item` (object)

  - `bonus.item.description` (string)
    Descripción del artículo.
    Example: "Game description"

  - `bonus.item.image_url` (string)
    URL de la imagen.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `bonus.item.name` (string)
    Nombre del artículo.
    Example: "Game name"

  - `bonus.item.sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "game_01"

  - `bonus.item.type` (string)
    Tipo de artículo: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `bonus.item.unit_items` (array)
    Si el artículo tiene el tipo de unidad, incluye todos los artículos de la unidad. En la mayoría de los casos, el usuario debe elegir uno de ellos como bonificación del código promocional.

  - `bonus.item.unit_items.drm_name` (string)
    Nombre del DRM (gestión de derechos digitales).
    Example: "Steam"

  - `bonus.item.unit_items.drm_sku` (string)
    ID único de DRM. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "steam"

  - `bonus.item.unit_items.is_free` (boolean)
    Si es true, el artículo es gratuito.

  - `bonus.item.unit_items.type` (string)
    Tipo de artículo: game_key.
    Example: "game_key"

  - `bonus.quantity` (number)
    Cantidad del artículo.

  - `discount` (object,null)
    Porcentaje de descuento.
El precio de la cesta se reducirá utilizando un valor calculado utilizando este porcentaje y luego se redondeará al segundo decimal.

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

  - `discounted_items` (array,null)
    Lista de artículos con descuento mediante un código promocional.

  - `discounted_items.discount` (object, required)

  - `discounted_items.discount.percent` (string, required)
    Porcentaje de descuento.

El precio del artículo de la cesta se reducirá utilizando un valor
calculado utilizando este porcentaje y luego se redondeará
al segundo decimal.
    Example: "10.00"

  - `discounted_items.sku` (string, required)
    SKU del artículo.

  - `is_selectable` (boolean)
    Si es true, el usuario debe elegir la bonificación antes de canjear un código promocional.

## 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 promo code."

  - `statusCode` (integer)
    Example: 404