요금제 업데이트

Xsolla Developers

또는

관리자 페이지로

요금제 업데이트Server-sideAdmin

put/projects/{project_id}/subscriptions/plans/{plan_id}

정기 결제 요금제 매개 변수를 업데이트합니다.

SecuritybasicAuth

Request

path Parameters

project_id required	integer 프로젝트 ID입니다.
plan_id required	integer 요금제 ID입니다.

Request Body schema: application/json

object

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

value

required

integer

청구 재시도 횟수입니다.

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

요금제 설명입니다. "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

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

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 베트남어.

refund_period

integer or null

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

object

value

string

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

Enum: "active" "disabled"

tags

Array of strings

요금제 태그입니다.

object

무료 체험 세부 정보입니다. 이 매개 변수가 전달되지 않으면 기본값 (0일)을 사용합니다.

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

Responses

200

OK(확인).

Request samples

application/json

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

Response samples

application/json

{"billing_retry": {"value": 1
},
"charge": {"amount": 20,
"currency": "USD",
"period": {"type": "month",
"value": 1
},
"prices": [{"amount": 17,
"currency": "EUR",
"setup_fee": 1.5
},
{"amount": 2000,
"currency": "JPY",
"setup_fee": 2.5
}
]
},
"description": {"en": "3x more experience!"
},
"expiration": {"type": "day",
"value": 0
},
"external_id": "exp",
"grace_period": {"type": "day",
"value": 2
},
"group_id": null,
"id": 241082,
"localized_name": "Experience boost",
"name": {"en": "Experience boost"
},
"project_id": 40797,
"refund_period": null,
"status": {"value": "active"
},
"tags": [ ],
"trial": {"type": "day",
"value": 7
},
"type": "all"
}