POST `/admin/billing/refund-approval`

发起退款审批流程，记录退款金额、原因和关联交易。审批通过后由管理员执行实际退款操作。

计费服务 `bearerAuth` application/json

请求体

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

字段	类型	必填	示例	约束	描述
`amount`	`number`	是	`99`
`invoice_number`	`string`	是	`INV-2026-001`
`reason`	`string`	是	`服务不满意`
`transaction_id`	`string`	是	`txn_abc123`
`reviewer_comments`	`string`	否	`审批通过`

响应

状态	描述	Schema
200	退款审批提交成功	`service-billing/internal/handler/dto.RefundApprovalDetailResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未授权	`dto.SimpleResponse`
403	无权限	`dto.SimpleResponse`
500	服务器内部错误	`dto.SimpleResponse`

引用的 Schema

dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.RefundApprovalDetailResponse

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

service-billing/internal/handler/dto.RefundApprovalResponse

字段	类型	必填	示例	约束	描述
`amount`	`number`	否	`99`
`approved_at`	`string`	否	`2026-04-15T14:00:00Z`
`approved_by`	`string`	否	`admin@example.com`
`invoice_number`	`string`	否	`INV-2026-001`
`refund_id`	`string`	否	`ref_001`
`status`	`string`	否	`approved`
`transaction_id`	`string`	否	`txn_abc123`

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