查询订单详情

获取指定订单的详细信息。

请求

GET /open-api/v1/orders/{orderId}

路径参数

参数	类型	必填	说明
orderId	long	是	订单 ID

请求参数

参数	类型	必填	说明
merchantId	long	是	商户 ID（需传入订单所属商户，用于权限校验）

请求示例

curl -X GET 'https://openapi.example.com/open-api/v1/orders/9001?merchantId=1001' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

响应

响应参数

字段	类型	说明
id	long	订单 ID
merchantId	long	商户 ID
storeId	long	门店 ID
totalAmount	int	总金额（分）
status	int	订单状态（见下方状态说明）
items	array	订单明细列表
items[].itemType	int	商品类型
items[].itemId	long	关联 ID
items[].itemName	string	商品/服务名称
items[].price	int	单价（分）
items[].quantity	int	数量
remark	string	备注
createTime	string	创建时间
payTime	string	支付时间
completeTime	string	完成时间

订单状态说明

状态值	说明
0	待支付
1	已支付
2	服务中
3	已完成
4	已取消
5	已退款

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 9001,
    "merchantId": 1001,
    "storeId": 2001,
    "totalAmount": 29900,
    "status": 1,
    "items": [
      {
        "itemType": 1,
        "itemId": 4001,
        "itemName": "深层清洁护理",
        "price": 29900,
        "quantity": 1
      }
    ],
    "remark": "下午3点到店",
    "createTime": "2026-03-10T15:00:00+08:00",
    "payTime": "2026-03-10T15:01:30+08:00",
    "completeTime": null
  }
}

相关接口

接口	路径	说明
查询订单状态历史	GET /open-api/v1/orders/{orderId}/status-history?merchantId=	获取订单状态流转记录
申请退款	POST /open-api/v1/orders/{orderId}/refund?merchantId=	对已支付订单申请退款
核销订单	POST /open-api/v1/orders/{orderId}/write-off?merchantId=	核销服务类订单