订阅价格变更

post

https://{api}.subotiz.com/api/v1/subscription/{subscription_id}

商家发起订阅定价方案变更

Path Params

subscription_id

string

required

订阅ID

Body Params

subscription_id

string

订阅ID

merchant_id

string

商户唯一标识

price_id

string

变更后定价 ID

effective_type

string

变更类型：

end_of_period - 下期
immediate - 立即

proration

string

比例分摊类型：

none - 无需结算分摊额（不考虑当前变更产生的差额，当前计费周期结束时将按新定价生成发票）
immediate - 立即结算（根据定价变更所产生的差额，将立即根据分摊额生成收款或退款的发票）

quantity

string

变更后订阅数量（席位数，1-999999999）。复用本定价变更接口承载数量变更，仅 billing_dimension=quantity 订阅支持；
本字段为纯写命令（下周期生效，不含试算），传值时表示发起数量变更，不传则维持原数量。试算请用只读接口 PreviewSubscriptionQuantity。

Headers

Request-Id

string

required

Defaults to 008e3967-a1b5-48bb-be14-d5bff5092e61

请求的唯一标识符

Responses

200OK

500Internal server error