套餐
用余额购买 30 天套餐
从余额扣费:按档位价格买 30 天,不会自动续费(立即开始,或在当前周期结束后开始)。maxCents 是扣款上限(超过上限返回 409 price_changed)。requestId 必填:用它重试返回同一周期,绝不重复扣费。刷卡套餐有效时不接受此操作。
POST/v1/account/plan/balanceAPI key会扣余额
请求体
tierstring必填
每 30 天:Base 499、Pro 1499、Max 3999 美分。
可选值: basepromax
maxCentsinteger必填
你同意支付的金额上限,单位美分。
取值范围: 0 <= x
requestIdstring必填
这次购买的幂等键;重试时复用,再次购买时换一个新键。
返回字段
outcomestring
可选值: startedqueuedreplayed
startsAtstring
endsAtstring
centsinteger
tiersPlanTier[]
planobject | null
balanceobject
baseTrialobject
usageobject
trialobject
状态码
201购买成功(HTTP 201);响应体同时包含更新后的套餐状态。
400参数或请求体无效;
message 说明应传什么。401没有有效的 API key(缺失、格式错误、不存在或已删除)。
402
code: insufficient_balance;不扣费。409
code 为以下之一:price_changed(带 cents)、card_active、fix_payment、checkout_open、already_queued、request_conflict。不扣费。503
code: stripe_unavailable 或暂时不可用;不扣费。