PUT `/admin/billing/subscription/{tenant_id}`

修改指定租户的订阅配置，支持变更套餐（plan）和自动续费（auto_renew）设置。套餐变更时按比例计算费用。

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID

请求体

Schema： service-billing/internal/handler/dto.UpdateSubscriptionRequestDTO

字段	类型	必填	示例	约束	描述
`auto_renew`	`boolean`	否	`False`
`billing_cycle`	`string`	否	`yearly`
`plan`	`string`	否	`enterprise`

响应

状态	描述	Schema
200	订阅更新成功	`service-billing/internal/handler/dto.SubscriptionDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
403	无权限	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.SubscriptionDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-billing/internal/handler/dto.SubscriptionResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.SubscriptionResponse

字段	类型	必填	示例	约束	描述
`admin_user_id`	`string`	否	`usr_abc123`
`amount`	`number`	否	`499`
`auto_renew`	`boolean`	否	`True`
`billing_cycle`	`string`	否	`monthly`
`cancel_at_period_end`	`boolean`	否	`False`
`currency`	`string`	否	`CNY`
`current_period_end`	`string`	否	`2026-02-01T00:00:00Z`
`current_period_start`	`string`	否	`2026-01-01T00:00:00Z`
`grace_period_days`	`integer`	否	`7`
`plan_id`	`string`	否	`pro`
`status`	`string`	否	`active`
`tenant_id`	`string`	否	`tnt_xyz789`
`trial_end_date`	`string`	否	`2026-01-15T00:00:00Z`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓