Gets promo code rewards by its code.
Can be used to allow users to choose one of many items as a bonus.
The usual case is choosing a DRM if the promo code contains a game as a bonus (type=unit
).
project_id required | integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056 |
promocode_code required | string [ 1 .. 128 ] characters Unique case sensitive code. Contains letters and numbers. Example: SO6rew99j9 |
List of promo code rewards was successfully received.
Authentication not passed or wrong.
Authorization header not sent.
Enter valid promo code.
Invalid request.
{- "bonus": [
- {
- "item": {
- "sku": "game_1",
- "name": "Game name",
- "type": "unit",
- "description": "Game description",
- "unit_items": [
- {
- "sku": "game_key_01",
- "name": "Game name",
- "type": "game_key",
- "is_free": false,
- "drm_name": "Steam",
- "drm_sku": "steam"
}, - {
- "sku": "game_key_02",
- "name": "Game name",
- "type": "game_key",
- "drm_name": "Origin",
- "drm_sku": "origin"
}
]
}, - "quantity": 1
}, - {
- "item": {
- "sku": "game_2",
- "name": "Game name",
- "type": "unit",
- "description": "Game description",
- "unit_items": [
- {
- "sku": "game_key_01",
- "type": "game_key",
- "name": "Game name",
- "drm_name": "Steam",
- "drm_sku": "steam"
}
]
}, - "quantity": 2
}
], - "discount": {
- "percent": "10.00"
}, - "is_selectable": true,
- "discounted_items": [
- {
- "sku": "elven_sword",
- "discount": {
- "percent": "10.00"
}
}
]
}