Xsolla-logo

캠페인 생성

post/merchants/{merchant_id}/coupon_promotions

새 쿠폰 캠페인을 생성합니다.

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

판매자 ID입니다.

Request Body schema: application/json
campaign_code
required
string

캠페인 이름.

project_id
required
integer

프로젝트 ID.

required
object

현지화된 캠페인 이름을 포함하는 오브젝트입니다.

campaign_redeems_count_for_user
integer

캠페인 내 사용자 당 최대 쿠폰 사용 횟수입니다. null이 전달되면 사용 횟수가 무제한으로 설정됩니다.

expiration_date
string <datetime>

캠페인 만료일은 ISO 8601 에 따라 YYYY-MM-DD’T’HH:MM:SS 형식입니다.

redeems_count
integer

최대 쿠폰 사용 횟수입니다. null이(가) 전달되면 사용 횟수가 무제한으로 설정됩니다.

redeems_count_for_user
integer

사용자 당 최대 쿠폰 사용 횟수입니다. null이(가) 전달되면 사용 횟수가 무제한으로 설정됩니다.

object

보상에 구독 매개변수를 포함하는 오브젝트입니다.

virtual_currency_amount
number <float>

보상에 포함된 가상 화폐 금액입니다.

object

보상에 포함된 가상 아이템 항목 매개변수의 배열입니다.

Responses
201

생성됨.

Request samples
application/json
{
  • "campaign_code": "sample_campaign",
  • "campaign_names": {
    },
  • "campaign_redeems_count_for_user": "1",
  • "expiration_date": "2019-12-31",
  • "project_id": "12345",
  • "redeems_count": "10",
  • "redeems_count_for_user": "1",
  • "subscription_coupon": null,
  • "virtual_currency_amount": "200"
}
Response samples
application/json
{
  • "id": 9134
}