/admin/billing/dunning-settings/{tenant_id}
创建或更新租户的失败支付催缴策略，包括：重试排程、宽限期天数、自动取消天数和邮件模板。支持 upsert——已有配置时更新，无配置时创建。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
tenant_id |
path |
string |
是 | 租户ID |
请求体
Schema： service-billing/internal/handler/dto.DunningSettingsRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
auto_cancel_days |
integer |
否 | 30 |
||
email_templates |
string |
否 | |||
grace_period_days |
integer |
否 | 7 |
||
retry_schedule |
string |
否 | [1,3,7,14] |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 催缴配置更新成功 | service-billing/internal/handler/dto.DunningSettingsDetailResponse |
| 400 | 请求参数错误 | object |
| 401 | 未授权 | object |
| 403 | 无权限 | object |
| 500 | 服务器内部错误 | object |
引用的 Schema
service-billing/internal/handler/dto.DunningSettingsDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-billing/internal/handler/dto.DunningSettingsResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-billing/internal/handler/dto.DunningSettingsResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
auto_cancel_days |
integer |
否 | 30 |
||
created_at |
string |
否 | 2026-05-12T10:00:00Z |
||
email_templates |
string |
否 | |||
grace_period_days |
integer |
否 | 7 |
||
retry_schedule |
string |
否 | [1,3,7,14] |
||
status |
string |
否 | active |
||
tenant_id |
string |
否 | tnt_xyz789 |
||
updated_at |
string |
否 | 2026-05-12T10:00:00Z |