POST `/billing/prorations/calculate/{tenant_id}`

在正式变更套餐前预览将产生的按比例（proration）金额，返回预估费用和剩余计费天数，不执行实际变更

计费服务 `bearerAuth` application/json

请求参数

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

请求体

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

字段	类型	必填	示例	约束	描述
`new_plan`	`string`	是	`enterprise`
`billing_cycle`	`string`	否	`monthly`

响应

状态	描述	Schema
200	按比例费用计算成功	`service-billing/internal/handler/dto.ProrationCalculateDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.ProrationCalculateDetailResponse

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

service-billing/internal/handler/dto.ProrationCalculateResponse

字段	类型	必填	示例	约束	描述
`currency`	`string`	否	`CNY`
`current_billing_end`	`string`	否	`2026-06-01T00:00:00Z`
`current_plan`	`string`	否	`pro`
`message`	`string`	否	`升级将产生按比例费用 ¥249.50（剩余15天）`
`proration_amount`	`number`	否	`249.5`
`remaining_days`	`integer`	否	`15`
`target_plan`	`string`	否	`enterprise`
`tenant_id`	`string`	否	`tnt_xyz789`

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