# Lire les récompenses d'un coupon

Récupère les récompenses associées au coupon 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 coupon contient un jeu comme bonus (type=unit).

Endpoint: GET /v2/project/{project_id}/coupon/code/{coupon_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

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

## Response 200 fields (application/json):

  - `bonus` (array)

  - `bonus.item` (object)

  - `bonus.item.bundle_type` (string)
    Type de lot. Renvoyé si le type d'objet est un lot.
    Enum: "standard", "virtual_currency_package"

  - `bonus.item.content` (array)

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

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

  - `bonus.item.name` (object)
    Nom de l'objet.
    Example: {"en":"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 coupon.

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

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

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

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