A AuthMS API Wiki API Reference iam.tianv.com →

POST /admin/billing/refund-approval

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

计费服务 `bearerAuth` application/json

Request Body

Schema: dto.RefundApprovalRequest

FieldTypeRequiredExampleConstraintsDescription
amount number Yes 99
invoice_number string Yes INV-2026-001
reason string Yes 服务不满意
transaction_id string Yes txn_abc123
reviewer_comments string No 审批通过

Responses

StatusDescriptionSchema
200退款审批提交成功dto.RefundApprovalDetailResponse
400请求参数错误object
401未授权object
403无权限object
500服务器内部错误object

Referenced Schemas

dto.RefundApprovalDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.RefundApprovalResponse No
message string No
timestamp string No

dto.RefundApprovalResponse

FieldTypeRequiredExampleConstraintsDescription
amount number No 99
approved_at string No 2026-04-15T14:00:00Z
approved_by string No admin@example.com
invoice_number string No INV-2026-001
refund_id string No ref_001
status string No approved
transaction_id string No txn_abc123