POST `/admin/billing/refund-approval`

Initiate a refund approval process, recording refund amount, reason and related transaction. After approval, the administrator performs the actual refund operation.

Billing Service `bearerAuth` application/json

Request Body

Schema: dto.RefundApprovalRequest

Field	Type	Required	Example
`amount`	`number`	Yes	`99`
`invoice_number`	`string`	Yes	`INV-2026-001`
`reason`	`string`	Yes	`Dissatisfied with service`
`transaction_id`	`string`	Yes	`txn_abc123`
`reviewer_comments`	`string`	No	`Approval approved`

Responses

Status	Description	Schema
200	Refund approval submitted successfully	`dto.RefundApprovalDetailResponse`
400	Invalid request parameters	`dto.SimpleResponse`
401	Unauthorized	`dto.SimpleResponse`
403	No permission	`dto.SimpleResponse`
500	Internal server error	`dto.SimpleResponse`

Referenced Schemas

dto.RefundApprovalDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.RefundApprovalResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.RefundApprovalResponse

Field	Type	Required	Example
`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`

dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /admin/billing/refund-approval