订单管理 API

接口概览

订单管理模块支持从订单创建到完成的全生命周期管理，包括创建订单、查询订单、取消订单和订单状态回调。

创建订单

请求

POST /open/v1/order/create
Content-Type: application/json

{
  "guideId": "G10001",
  "tripDate": "2026-05-01",
  "tripDays": 3,
  "guestCount": 4,
  "contactName": "李先生",
  "contactPhone": "138****1234",
  "remark": "需要英文导游"
}

响应

{
  "code": 200,
  "data": {
    "orderId": "ORD20260501001",
    "status": "pending",
    "totalAmount": 2400.00
  }
}

查询订单

GET /open/v1/order/detail/{orderId}

订单状态流转

1. pending — 待确认
2. confirmed — 已确认
3. in_progress — 服务中
4. completed — 已完成
5. cancelled — 已取消

状态回调

订单状态变更时，平台会向商户配置的回调地址发送 POST 通知，请在收到通知后返回 {"code": 200} 确认。