Redeem coupon code
post/v2/project/{project_id}/coupon/redeem
Redeems a coupon code. The user gets a bonus after a coupon is redeemed.
SecurityXsollaLoginUserJWT
Request
path Parameters
| project_id required | integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056 |
Request Body schema: application/json
Responses
200
Coupon was successfully redeemed.
401
Authentication not passed or wrong.
403
Authorization header not sent.
404
Enter valid coupon code.
422
Invalid request.
Request samples
- Payload
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
application/json
{- "coupon_code": "WINTER2021",
- "selected_unit_items": {
- "game_1": "game_1_steam",
- "game_2": "game_2_playstation"
}
}Response samples
- 200
- 401
- 403
- 404
- 422
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"
}
], - "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": [ ]
}
]
}