diff --git a/src/document/openapi/cn/components_order.yml b/src/document/openapi/cn/components_order.yml
index ea5149033..651cdd86c 100644
--- a/src/document/openapi/cn/components_order.yml
+++ b/src/document/openapi/cn/components_order.yml
@@ -171,6 +171,11 @@ orderStatus:
       format: 'date-time'
       pattern: yyyy-mm-dd HH:mm:ss
       description: 订单创建时间（最新订单为准）（yyyy-MM-dd HH:mm:ss，GMT+10）
+    settlement_date:
+      type: string
+      format: date
+      pattern: yyyy-mm-dd
+      description: 预期清算日期（可能受到账情况、节假日影响）(yyyy-MM-dd)
     channel:
       type: string
       description: 支付渠道
diff --git a/src/document/openapi/en/components_order.yml b/src/document/openapi/en/components_order.yml
index 26c44a097..a46973900 100644
--- a/src/document/openapi/en/components_order.yml
+++ b/src/document/openapi/en/components_order.yml
@@ -168,6 +168,11 @@ orderStatus:
       format: 'date-time'
       pattern: yyyy-mm-dd HH:mm:ss
       description: order creation time(yyyy-MM-dd HH:mm:ss, GMT+10)
+    settlement_date:
+      type: string
+      format: date
+      pattern: yyyy-mm-dd
+      description: target settlement date, maybe delay due to holidays and bank issues(yyyy-MM-dd)
     channel:
       type: string
       description: payment channel