兑换优惠券码

兑换优惠券码Client-side

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

兑换优惠券码。用户在兑换优惠券后获得奖励。

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056

Request Body schema: application/json

coupon_code

string [ 1 .. 128 ] characters

Default: "WINTER2021"

唯一优惠券码。包含字母和数字。

object

用户选择的奖励。对象键是单位的SKU，值是单位中一个商品的SKU。

property name*

additional property

string

Responses

200

优惠券已成功兑换。

401

认证未通过或错误。

403

未发送授权标头。

404

输入有效的优惠券码。

422

无效的请求。

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": [ ]
}
]
}