POST/api/v1/orders/:orderId/pay支付订单

Try it 面板需要启用 JavaScript。

以已绑定支付方式或一次性渠道 token 支付订单；成功后发布 payment.order.paid 通知业务服务。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Authorization": "Bearer st_7c1f9e05b28d4a63",
  "Content-Type": "application/json"
}

URL Parameters

Name	Data Type	Description
orderId	string	订单 ID

Body

Name	Data Type	Required	Description
methodId	string	No	已绑定的支付方式 ID（二选一）
providerToken	string	No	一次性渠道 token（二选一）

type RequestBody = {
  /** 已绑定的支付方式 ID（二选一） */
  methodId?: string
  /** 一次性渠道 token（二选一） */
  providerToken?: string
}

{
  "methodId": "01JD8SNR8N0S3W9ZS4W7ZFM1X5G"
}

Response

Body

Name	Data Type	Required	Description
orderId	string	Yes	订单 ID
status	string	Yes	固定为 paid
paidAt	string	Yes	支付完成时间

type ResponseBody = {
  /** 订单 ID */
  orderId: string
  /** 固定为 paid */
  status: string
  /** 支付完成时间 */
  paidAt: string
}

{
  "orderId": "01JD8SNZFT8A1B7HB",
  "status": "paid",
  "paidAt": "2026-10-14T15:03:12Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	支付完成
400	支付被拒绝	渠道侧拒绝该笔支付
409	状态不允许	订单不是待支付状态

Response Code

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

code	Meaning	Notes
0	成功	支付完成
2801	渠道 token 无效	providerToken 校验失败
2802	订单状态不允许支付	订单已支付 / 已取消 / 已退款
2804	支付被拒绝	渠道侧拒绝该笔支付

Examples

POST /api/v1/orders/01JD8SNZFT8A1B7HB/pay
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

{
  "methodId": "01JD8SNR8N0S3W9ZS4W7ZFM1X5G"
}

{
  "id": "01JD8SSSIN7I5KD",
  "code": 0,
  "messages": [],
  "result": {
    "orderId": "01JD8SNZFT8A1B7HB",
    "status": "paid",
    "paidAt": "2026-10-14T15:03:12Z"
  }
}

Remarks

支付成功是异步通知业务服务的触发点：payment.order.paid 事件由 payment_service 发布，业务服务自行消费并交付业务结果。