Xsolla-logoXsolla Developers
或
前往发布商帐户

兑换促销码Client-side

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
{
  • "errorCode": 4001,
  • "errorMessage": "[0401-9807]: Enter valid promo code.",
  • "statusCode": 404
}
系统状态所有服务正常提供

Do Not Sell My Personal Information

隐私政策终端用户许可协议© 2006–2025 Xsolla Inc.