요금제 생성

Xsolla Developers

또는

관리자 페이지로

요금제 생성Server-sideAdmin

post/projects/{project_id}/subscriptions/plans

정기 결제 요금제를 생성합니다.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

프로젝트 ID입니다.

Request Body schema: application/json

required

object

요금제 이름입니다. "localization":"plan name" 쌍으로 구성된 값입니다.

ar	string 아랍어.
bg	string 불가리아어.
cn	string 중국어(간체).
cs	string 체코어.
de	string 독일어.
en	string 영어.
es	string 스페인어.
fr	string 프랑스어.
he	string 히브리어.
it	string 이탈리아어.
ja	string 일본어.
ko	string 한국어.
pl	string 폴란드어.
pt	string 포르투갈어.
ro	string 루마니아어.
ru	string 러시아어.
th	string 태국어.
tr	string 터키어.
tw	string 중국어(번체).
vi	string 베트남어.

required

object

청구 세부 정보입니다.

required

object

청구 기간입니다.

value required	integer 시간 단위 수입니다. 값은 유형 매개 변수에 따라 달라지며 다음이 될 수 있습니다: `type`이 `day`인 경우 1366, `type`이 `month`인 경우 112, `type`이 `lifetime`인 경우 0
type required	string 시간 단위입니다. `day`, `month` 혹은 `lifetime`일 수 있습니다. Enum: "day" "month" "lifetime"

amount

number <float>

청구 금액입니다.

currency

string

구매 통화입니다. ISO 4217에 따른 3자릿수 통화 코드입니다.

Array of objects

다양한 통화로 되어 있는 가격 목록입니다.

Array

amount required	number <float> 청구 금액입니다.
currency required	string 구매 통화입니다. ISO 4217에 따른 3자릿수 통화 코드입니다.
setup_fee	number <float> 첫 청구서의 일부로 청구되는 일회성 설정 수수료입니다.

object

청구 재시도 세부 정보입니다.

value

required

integer

청구 재시도 횟수입니다.

object

요금제 설명입니다. "localization":"plan description" 쌍으로 구성된 값입니다.

ar	string 아랍어.
bg	string 불가리아어.
cn	string 중국어(간체).
cs	string 체코어.
de	string 독일어.
en	string 영어.
es	string 스페인어.
fr	string 프랑스어.
he	string 히브리어.
it	string 이탈리아어.
ja	string 일본어.
ko	string 한국어.
pl	string 폴란드어.
pt	string 포르투갈어.
ro	string 루마니아어.
ru	string 러시아어.
th	string 태국어.
tr	string 터키어.
tw	string 중국어(번체).
vi	string 베트남어.

object

정기 결제 만료 세부 정보입니다.

value required	integer or null 만료 전 남은 기간입니다.
type required	string 시간 단위입니다. `day` 혹은 `month`일 수 있습니다. Enum: "day" "month"

external_id

string

요금제 외부 ID(32자)입니다.

object

유예 기간 세부 정보입니다.

value required	integer 시간 단위 수입니다.
type required	string 시간 단위입니다. `day`일 수 있습니다. Value: "day"

group_id

string or null

이러한 요금제가 연결된 그룹의 ID입니다.

integer

정기 결제 요금제 ID입니다.

project_id

integer

프로젝트 ID입니다.

refund_period

integer or null

사용자가 정기 결제 요금제 지급금을 환불할 수 있는 기간(일 단위)입니다.

object

value

string

정기 결제 요금제 상태입니다.

Enum: "active" "disabled"

tags

Array of strings

요금제 태그입니다.

object

무료체험 기간 세부 정보입니다.

value required	integer 시간 단위 수입니다.
type required	string 시간 단위입니다. `day`일 수 있습니다. Value: "day"

Responses

201

생성됨.

Request samples

application/json

{"billing_retry": {"value": 1
},
"charge": {"amount": 10,
"currency": "USD",
"period": {"type": "month",
"value": 1
},
"prices": [{"amount": 8,
"currency": "EUR",
"setup_fee": 1.5
},
{"amount": 1000,
"currency": "JPY",
"setup_fee": 2.5
}
]
},
"description": {"en": "2x more experience!"
},
"expiration": {"type": "day",
"value": null
},
"external_id": "exp",
"grace_period": {"type": "day",
"value": 2
},
"name": {"en": "Experience boost"
},
"refund_period": null,
"status": {"value": "active"
},
"trial": {"type": "day",
"value": 7
}
}

Response samples

application/json

{"external_id": "exp",
"plan_id": 241082
}