POST /billing/subscribe
为当前租户创建订阅,绑定套餐(free/basic/pro/enterprise/platform)和计费周期(monthly/yearly)。支持设定自动续费和试用天数。
计费服务 `bearerAuth` application/json
Request Body
Schema: dto.SubscribeRequestDTO
| Field | Type | Required | Example | Constraints | Description |
billing_cycle |
string |
Yes |
monthly |
|
|
plan |
string |
Yes |
pro |
|
|
auto_renew |
boolean |
No |
True |
|
|
trial_days |
integer |
No |
14 |
|
|
Referenced Schemas
dto.SubscriptionDetailResponse
| Field | Type | Required | Example | Constraints | Description |
code |
integer |
No |
|
|
|
data |
dto.SubscriptionResponse |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.SubscriptionResponse
| Field | Type | Required | Example | Constraints | Description |
admin_user_id |
string |
No |
usr_abc123 |
|
|
amount |
number |
No |
499 |
|
|
auto_renew |
boolean |
No |
True |
|
|
billing_cycle |
string |
No |
monthly |
|
|
cancel_at_period_end |
boolean |
No |
False |
|
|
currency |
string |
No |
CNY |
|
|
current_period_end |
string |
No |
2026-02-01T00:00:00Z |
|
|
current_period_start |
string |
No |
2026-01-01T00:00:00Z |
|
|
grace_period_days |
integer |
No |
7 |
|
|
plan_id |
string |
No |
pro |
|
|
status |
string |
No |
active |
|
|
tenant_id |
string |
No |
tnt_xyz789 |
|
|
trial_end_date |
string |
No |
2026-01-15T00:00:00Z |
|
|