Xsolla-logo

Échanger un code promo

post/v2/project/{project_id}/promocode/redeem

Échange un code d'une promotion par code promo. Après avoir échangé un code de promo, l'utilisateur reçoit des biens gratuits et/ou le prix du panier et/ou des objets spécifiques sera réduit.

SecurityAuthForCart
Request
path Parameters
project_id
required
integer

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Example: 44056
Request Body schema: application/json
object or null
id
required
string
Default: "current"

ID de panier.

coupon_code
string [ 1 .. 128 ] characters
Default: "SUMMER2021"

Code unique du code promo. Comprend des lettres et des chiffres.

object

Récompense sélectionnée par l'utilisateur. La clé d'objet est l'UGS d'une unité et la valeur est l'UGS de l'un des objets de l'unité.

property name*
additional property
string
Responses
200

Le code promo a été utilisé avec succès.

401

L'authentification n'a pas été passée ou est incorrecte.

403

L'en-tête d'autorisation n'a pas été passé.

404

Entrez un code promo valide.

422

Requête non valide.

Request samples
application/json
{
  • "cart": {
    },
  • "coupon_code": "SUMMER2021",
  • "selected_unit_items": {
    }
}
Response samples
application/json
{
  • "cart_id": "cart_id",
  • "is_free": false,
  • "items": [
    ],
  • "price": {
    },
  • "rewards": {
    }
}