クポーンコードを引き換える

クポーンコードを引き換えるClient-side

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

クーポンコードを引き換えます。クーポンが引き換えられた後、ユーザーはボーナスを得ることができます。

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

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

Example: 44056

Request Body schema: application/json

coupon_code

string [ 1 .. 128 ] characters

Default: "WINTER2021"

一意のコードです。文字と数字が含まれます。

object

ユーザーが選択したリワード。オブジェクトのキーはユニットのSKUで、値はユニット内の1つのアイテムの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": [ ]
}
]
}