Redeem promo code
post/v2/project/{project_id}/promocode/redeem
Redeems a code of promo code promotion. After redeeming a promo code, the user will get free items and/or the price of the cart and/or particular items will be decreased.
SecurityAuthForCart
Request
Responses
200
Promo code was successfully redeemed.
401
Authentication not passed or wrong.
403
Authorization header not sent.
404
Enter valid promo code.
422
Invalid request.
Request samples
- Payload
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
application/json
{- "coupon_code": "SUMMER2021",
- "cart": {
- "id": "current"
}, - "selected_unit_items": {
- "game_1": "game_1_steam",
- "game_2": "game_2_playstation"
}
}Response samples
- 200
- 401
- 403
- 404
- 422
application/json
{- "cart_id": "cart_id",
- "is_free": false,
- "items": [
- {
- "attributes": [ ],
- "description": "Take it, take it all! All of Xsolla's riches in one Mega Booster.",
- "groups": [
- {
- "external_id": "powerups",
- "name": "Power Ups"
}
], - "is_free": false,
- "name": "Xsolla Booster Mega",
- "price": {
- "amount": "50.0000000000000000",
- "amount_without_discount": "100.0000000000000000",
- "currency": "USD"
}, - "quantity": 123,
- "sku": "booster_mega_1",
- "type": "virtual_good",
- "virtual_item_type": "consumable",
- "virtual_prices": [ ]
}, - {
- "attributes": [ ],
- "description": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel.",
- "groups": [ ],
- "is_free": true,
- "name": "Sword Xsolla Skin",
- "price": [ ],
- "quantity": 1,
- "sku": "swords_1",
- "type": "virtual_good",
- "virtual_item_type": "non_consumable",
- "virtual_prices": [ ],
- "is_bonus": true
}
], - "price": {
- "amount": "6150.0000000000000000",
- "amount_without_discount": "12300.0000000000000000",
- "currency": "USD"
}, - "rewards": {
- "bonus": [
- {
- "item": {
- "name": "Sword Xsolla Skin",
- "sku": "swords_1",
- "type": "virtual_good",
- "virtual_item_type": "non_consumable",
- "description": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel.",
}, - "quantity": 1
}
], - "discount": {
- "percent": null
}, - "discounted_items": [
- {
- "sku": "booster_mega_1",
- "discount": {
- "percent": "50.00"
}
}
], - "is_selectable": false
}
}