Xsolla-logo

プロモーションコードを引き換えるClient-side

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

プロモーションコードを引き換えます。 プロモーションコードを引き換えた後、ユーザーは無料でアイテムを入手したり、カートや特定のアイテムの価格を下げたりすることができます。

SecurityAuthForCart
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

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で、値はユニット内の1つのアイテムの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": {
    }
}