쿠폰 코드 사용

쿠폰 코드 사용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이며 값은 단위의 아이템 중 하나의 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": [ ]
}
]
}