NATSpayment.order.refund订单退款

Try it 面板需要启用 JavaScript。

管理侧全额退款；业务服务经对账事件感知。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
orderId	string	Yes	订单 ID
operatorId	string	Yes	操作管理员 ID（审计用）
reason	string	Yes	退款原因（审计用）

type RequestBody = {
  /** 订单 ID */
  orderId: string
  /** 操作管理员 ID（审计用） */
  operatorId: string
  /** 退款原因（审计用） */
  reason: string
}

{
  "orderId": "01JD8SNZFT8A1B7HB",
  "operatorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "reason": "用户投诉成立"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

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"
}

Response Code

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

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

Examples

{ "orderId": "01JD8SNZFT8A1B7HB", "operatorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "reason": "用户投诉成立" }

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