POST `/points/{user_id}/confirm-deduction`

从冻结余额中确认扣除积分。适用于订单确认后实际扣减冻结积分的场景。工作流：Freeze → ConfirmDeduction 或 Unfreeze。

积分服务 `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`user_id`	`path`	`string`	Yes				用户ID

Request Body

Schema: dto.ConfirmDeductionRequest

Field	Type	Required	Example	Constraints	Description
`amount`	`integer`	Yes
`reason`	`string`	No

Responses

Status	Description	Schema
200	扣除确认成功，返回账户和交易记录	`dto.PointOperationResponse`
400	请求参数错误或冻结余额不足	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	未认证	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	账户不存在	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	服务器内部错误	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.PointAccountResponse

Field	Type	Required	Example	Constraints	Description
`balance`	`integer`	No	`1500`
`created_at`	`string`	No	`2026-01-15T10:30:00Z`
`exchange_rate`	`integer`	No	`100`
`expired_points`	`integer`	No	`100`
`frozen_balance`	`integer`	No	`200`
`id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`points_type`	`string`	No	`cash_equivalent`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_example_001`
`total_earned`	`integer`	No	`5000`
`total_spent`	`integer`	No	`3500`
`updated_at`	`string`	No	`2026-04-10T14:20:00Z`
`user_id`	`string`	No	`usr_example_001`
`version`	`integer`	No	`3`

dto.PointOperationData

Field	Type	Required	Example	Constraints	Description
`account`	`dto.PointAccountResponse`	No
`points_earned`	`integer`	No	`100`
`transaction`	`dto.PointTransactionResponse`	No

dto.PointOperationResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`data`	`dto.PointOperationData`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.PointTransactionResponse

Field	Type	Required	Example	Constraints	Description
`account_id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`amount`	`integer`	No	`100`
`balance_after`	`integer`	No	`1500`
`balance_before`	`integer`	No	`1400`
`created_at`	`string`	No	`2026-04-15T10:30:00Z`
`description`	`string`	No	`每日签到奖励`
`expires_at`	`string`	No	`2027-01-15T10:30:00Z`
`id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`idempotency_key`	`string`	No	`ik_abc123`
`reason`	`string`	No	`签到奖励`
`related_id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`source`	`string`	No	`daily_checkin`
`status`	`string`	No	`completed`
`type`	`string`	No	`earn`
`updated_at`	`string`	No	`2026-04-15T10:30:00Z`
`user_id`	`string`	No	`usr_example_001`

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

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

↑