플랜 업데이트

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 시간 단위 수. 값은 유형 매개변수에 따라 다음과 같습니다: - 1 ~ 366, `type`이 `day`인 경우 - 1 ~ 12, `type`이 `month`인 경우 - 0 `type`이 `lifetime`인 경우
type required	string 시간 단위. `day`, `month` 혹은 `lifetime`. Enum: "day" "month" "lifetime"

amount

number <float>

지불 금액입니다.

currency

string

구매 통화입니다. 통화의 3자리 정의가 ISO 4217에 따라 사용됩니다.

Array of objects

다른 통화 시의 가격 목록.

Array

amount required	number <float> 지불 금액입니다.
currency required	string 구매 통화입니다. 통화의 3자리 정의가 ISO 4217에 따라 사용됩니다.
setup_fee	number <float> 첫 청구서의 일부인 1회성 설정비.

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 만료 전 남은 기간입니다.
type required	string 시간 단위. `day` 혹은 `month`. Enum: "day" "month"

external_id

string

외부 요금제 식별자입니다.

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

사용자의 구독 요금제에(일할 계산) 대하여 사용자 결제 요금에 대한 환불을 요청할 수 있는 시간 기간.

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": null,
"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"
}