POST `/wallets/{user_id}/coupons/{code}/redeem`

Redeem a coupon using a coupon code.

Wallet Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Description
`user_id`	`path`	`string`	Yes	User ID
`code`	`path`	`string`	Yes	Coupon code
`wallet_id`	`query`	`string`	No	Wallet ID

Status	Description	Schema
200	OK	`dto.RedeemCouponResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated or invalid token	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Coupon info

Field	Type	Required	Example	Description
`code`	`string`	No	`DISCOUNT20`	Code
`created_at`	`string`	No	`2026-01-01T00:00:00Z`	Created
`id`	`string`	No	`cpn_abc123`	ID
`min_amount`	`string`	No	`100.00`	Minimum spend
`name`	`string`	No	`20 yuan coupon`	Name
`status`	`string`	No	`unused`	Status
`type`	`string`	No	`cash`	Type
`used_at`	`string`	No		Usage time
`used_order_id`	`string`	No		Order ID
`valid_from`	`string`	No	`2026-01-01T00:00:00Z`	Active
`valid_until`	`string`	No	`2026-12-31T23:59:59Z`	Expired
`value`	`string`	No	`20.00`	Value

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

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