# Lire les récompenses d'un code promo

Récupère les récompenses associées au code promo par son code.
Peut être utilisé pour permettre aux utilisateurs de choisir l'un des nombreux objets proposés comme bonus.
Le cas habituel est le choix d'un DRM si le code promo contient un jeu comme bonus (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 de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
    Example: 44056

  - `promocode_code` (string, required)
    Code unique sensible à la casse. Comprend des lettres et des chiffres.
    Example: "SO6rew99j9"

## Response 200 fields (application/json):

  - `bonus` (array)

  - `bonus.item` (object)

  - `bonus.item.description` (string)
    Description de l'objet.
    Example: "Game description"

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

  - `bonus.item.name` (string)
    Nom de l'objet.
    Example: "Game name"

  - `bonus.item.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "game_01"

  - `bonus.item.type` (string)
    Type d'objet : virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `bonus.item.unit_items` (array)
    Si l'objet est de type unit, il inclut tous les objets dans l'unité. Dans la plupart des cas, l'utilisateur doit en choisir un comme bonus de code promo.

  - `bonus.item.unit_items.drm_name` (string)
    Nom du DRM.
    Example: "Steam"

  - `bonus.item.unit_items.drm_sku` (string)
    ID unique du DRM. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "steam"

  - `bonus.item.unit_items.is_free` (boolean)
    Si ce paramètre est défini sur true, l'objet est gratuit.

  - `bonus.item.unit_items.type` (string)
    Type d'objet : game_key.
    Example: "game_key"

  - `bonus.quantity` (number)
    Quantité de l'objet.

  - `discount` (object,null)
    Pourcentage de la remise.
Le prix du panier sera réduit d'une valeur calculée à l'aide de ce pourcentage et arrondie à 2 décimales.

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

  - `discounted_items` (array,null)
    Liste des objets bénéficiant d'une remise grâce à un code promo.

  - `discounted_items.discount` (object, required)

  - `discounted_items.discount.percent` (string, required)
    Pourcentage de la remise.

Le prix du panier sera réduit d'une valeur
calculée à l'aide de ce pourcentage et arrondie
à 2 décimales.
    Example: "10.00"

  - `discounted_items.sku` (string, required)
    UGS de l'objet.

  - `is_selectable` (boolean)
    Si true, l'utilisateur doit choisir le bonus avant d'échanger un code promo.

## 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