Échanger un code de coupon

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

Échange un code de coupon. L'utilisateur reçoit un bonus après l'échange.

SecurityXsollaLoginUserJWT

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

coupon_code

string [ 1 .. 128 ] characters

Default: "WINTER2021"

Code unique de coupon. 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 coupon a été échangé 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 de coupon valide.

422

Requête non valide.

Request samples

application/json

{"coupon_code": "WINTER2021",
"selected_unit_items": {"game_1": "game_1_steam",
"game_2": "game_2_playstation"
}
}

Response samples

application/json

{"items": [{"attributes": [ ],
"description": "Take it, take it all! All of Xsolla's riches in one Mega Booster.",
"groups": [{"external_id": "powerups",
"name": "Power Ups"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"is_free": true,
"name": "Xsolla Booster Mega",
"price": null,
"quantity": 1,
"sku": "booster_mega_1",
"type": "virtual_good",
"virtual_item_type": "consumable",
"virtual_prices": [ ]
}
]
}