# Lire les récompenses d'un code promo

Récupère les récompenses associées à un code promo à partir de son code.
Peut être utilisé pour permettre aux utilisateurs de choisir un objet parmi plusieurs bonus disponibles.
Un cas courant consiste à choisir un DRM lorsque le code promo inclut un jeu comme bonus (type=unit). 


  Note
    Cet appel API utilise un JWT utilisateur pour l'autorisation.
    Incluez le jeton dans l'en-tête Authorization au format suivant : Bearer <user_JWT>. Pour plus d'informations sur le JWT utilisateur, consultez le bloc Security pour cet appel.

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

## Path parameters:

  - `project_id` (integer, required)
    ID du projet. Vous trouverez ce paramètre dans le Compte éditeur, à côté du nom du projet, ainsi que dans l'URL affichée dans la barre d'adresse du navigateur lorsque vous utilisez ce projet. L'URL présente le format suivant : https://publisher.xsolla.com//projects/.
    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.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.name` (string)
    Nom de l'objet.
    Example: "Game name"

  - `bonus.item.type` (string)
    Type d'objet. Valeurs possibles :virtual_good — objets virtuelsvirtual_currency — monnaie virtuellebundle — lotunit — package de clés de jeu
    Example: "unit"

  - `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.unit_items` (array)
    Tableau de clés de jeu spécifiques à une plateforme. Utilisé uniquement lorsque le type d'objet est unit (bonus.item.type = 'unit'). Si le package de clés de jeu comprend des clés spécifiques à certaines plateformes, l'utilisateur peut en choisir une comme bonus.

  - `bonus.item.unit_items.sku` (string)
    Identifiant unique du package de clés de jeu spécifiques à une plateforme. Caractères autorisés : a-z, A-Z, 0-9, point (.), tiret (-) et tiret bas (_). Il combine les valeurs bonus.item.​sku et bonus.item.unit_items.drm_sku. Par exemple, si `bonus.item.​sku = 'cool_game' et bonus.item.unit_items.drm_sku = 'steam', la valeur sera cool_game_steam.
    Example: "cool_game_steam"

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

  - `bonus.item.unit_items.type` (string)
    Indique que l'objet est une clé de jeu.
    Enum: "game_key"

  - `bonus.item.unit_items.name` (string)
    Titre du jeu.
    Example: "Awesome Game"

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

  - `bonus.item.unit_items.drm_sku` (string)
    Identifiant DRM unique utilisé comme suffixe pour indiquer une clé de jeu spécifique à une plateforme. Caractères autorisés : a-z, A-Z, 0-9, point (.), tiret (-) et tiret bas (_).
    Example: "steam"

  - `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.sku` (string, required)
    UGS de l'objet.

  - `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.

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

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