보상 설정

Xsolla Developers

또는

관리자 페이지로

보상 설정Server-sideAdmin

put/merchants/{merchant_id}/promotions/{promotion_id}/rewards

프로모션에 대한 보상을 설정합니다. 프로모션이 읽기 전용(read_only = true)인 경우 보상을 업데이트할 수 없습니다.

주의

이 API 호출에는 project_id 경로 매개 변수가 포함되어 있지 않으므로 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 인증을 설정해야 합니다.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer 판매자 ID입니다.
promotion_id required	integer 프로모션 ID입니다.

Request Body schema: application/json

object

가상 아이템에 대한 보너스를 설정합니다.

Array of objects

보너스로 제공된 여분의 가상 아이템입니다.

Array

id	integer
localized_name	string 기본 언어(영어)로 표기된 요금제 명칭, name.en 값을 복제합니다.
quantity	integer 보너스로 제공된 가상 아이템 수입니다.
sku	string 아이템 SKU입니다.

Array of objects

특정 가상 아이템에 대한 할인율입니다.

Array

discount_percent	number <float> 할인율 수치입니다.
localized_name	string 기본 언어(영어)로 표기된 요금제 명칭, name.en 값을 복제합니다.
max_amount	number <integer> 프로모션이 적용되는 아이템의 최대 수량입니다.
sku	string 아이템 SKU입니다.

object

인게임 재화 패키지에 대한 보상을 설정합니다.

bonus_amount	number <float> 인게임 재화의 절대 수량으로 보상을 설정합니다.
bonus_percent	number <float> 패키지 금액에 대한 백분율로 보상을 설정합니다.

object

전체 구매에 대한 보상을 설정합니다.

discount_percent

number <float>

할인율 수치입니다.

object

정기 결제에 대한 보상을 설정합니다.

trial_days

integer

평가 기간(일)입니다.

Responses

204

콘텐츠가 없습니다.

Request samples

application/json

{"item": {"bonus": [{"quantity": 2,
"sku": "1234"
}
],
"discount": [{"discount_percent": 5,
"max_amount": 10,
"sku": "1234"
}
]
},
"package": {"bonus_amount": 5,
"bonus_percent": 5
},
"purchase": {"discount_percent": 10
},
"subscription": {"trial_days": 30
}
}