Xsolla-logo
  • 문서화
  • 계정 생성

프로모션 코드 사용

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이며 값은 단위의 아이템 중 하나의 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": {
    }
}