Xsolla-logo
  • 文档
  • 创建帐户

兑换促销码

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

兑换促销码活动的促销码。 兑换促销码后,用户将获得免费商品和/或购物车和/或特定商品的价格折扣。

SecurityAuthForCart
Request
path Parameters
project_id
required
integer

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

Example: 44056
Request Body schema: application/json
object or null
id
required
string
Default: "current"

购物车ID。

coupon_code
string [ 1 .. 128 ] characters
Default: "SUMMER2021"

唯一促销码代码。包含字母和数字。

object

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

property name*
additional property
string
Responses
200

促销码已成功兑换。

401

认证未通过或错误。

403

未发送授权标头。

404

输入有效的促销码。

422

无效的请求。

Request samples
application/json
{
  • "cart": {
    },
  • "coupon_code": "SUMMER2021",
  • "selected_unit_items": {
    }
}
Response samples
application/json
{
  • "cart_id": "cart_id",
  • "is_free": false,
  • "items": [
    ],
  • "price": {
    },
  • "rewards": {
    }
}