POST/api/v1/admin/orders/:orderId/refund订单退款

Try it 面板需要启用 JavaScript。

将已支付订单全额退款；渠道侧退款受理后发布 payment.order.paid 的对账事件核销，业务服务经对账流感知退款。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name	Data Type	Description
orderId	string	订单 ID

Response

Body

Name	Data Type	Required	Description
orderId	string	Yes	订单 ID
status	string	Yes	固定为 refunded
refundedAt	string	Yes	退款时间

type ResponseBody = {
  /** 订单 ID */
  orderId: string
  /** 固定为 refunded */
  status: string
  /** 退款时间 */
  refundedAt: string
}

{
  "orderId": "01JD8SNZFT8A1B7HB",
  "status": "refunded",
  "refundedAt": "2026-10-14T16:20:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	退款完成
409	状态不允许	订单未支付或已退款

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	退款完成
2806	订单状态不允许退款	订单未支付或已退款

Examples

POST /api/v1/admin/orders/01JD8SNZFT8A1B7HB/refund
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8STD3I8D1E5",
  "code": 0,
  "messages": [],
  "result": {
    "orderId": "01JD8SNZFT8A1B7HB",
    "status": "refunded",
    "refundedAt": "2026-10-14T16:20:00Z"
  }
}