diff --git a/frontend/src/openapi/endpoints.ts b/frontend/src/openapi/endpoints.ts
index f0773d0..12754aa 100644
--- a/frontend/src/openapi/endpoints.ts
+++ b/frontend/src/openapi/endpoints.ts
@@ -214,18 +214,34 @@ export const endpoints: EndpointSpec[] = [
       "order_no": "FO20260730000123",
       "client_order_no": "shop-10001",
       "order_status": "paid",
-      "can_ship": true
+      "can_ship": true,
+      "cannot_ship_reason": "",
+      "product": { "sku": "suit_pink_sheep", "name": "套装-糯粉咩咩" },
+      "quantity": 1,
+      "base_amount": 100,
+      "fee_type": "rate",
+      "service_fee_amount": 5,
+      "amount": 105,
+      "currency": "POINT",
+      "buyer_reference": "buyer-001",
+      "data": { "server": "ios-wechat", "uid": "player-id" },
+      "provider_order_no": "",
+      "failure_reason": "",
+      "created_at": "2026-07-30T10:00:00+08:00",
+      "delivered_at": null,
+      "cancelled_at": null
     }
   }
 }`,
     responseFields: [
-      { name: 'idempotent', type: 'bool', desc: 'true 表示该 client_order_no 已存在，返回既有订单' },
-      { name: 'order', type: 'object', desc: '订单对象，字段见「订单字段说明」' },
+      { name: 'idempotent', type: 'bool', desc: 'true 表示该 client_order_no 已存在，返回既有订单（未重复扣款）' },
+      { name: 'order', type: 'object', desc: '订单完整对象，字段见下方「订单字段说明」' },
     ],
     notes: [
-      'client_order_no 是唯一幂等单号，请保证同一商户下不重复。',
+      'client_order_no 是唯一幂等单号，请保证同一商户下不重复；重复请求不会重复扣款，返回 idempotent=true 及既有订单。',
       '当前无真实支付流程，下单成功即扣款并进入 order_status=paid，余额不足返回 400。',
-      '同一 client_order_no 重复请求不会重复扣款，返回 idempotent=true。',
+      '下单成功后请保存 order_no，后续查询/发货/回调均以 order_no 为准；client_order_no 仅用于幂等。',
+      'data 字段会原样存储并回显，可用于透传区服、账号等业务数据。',
     ],
   },
   {