diff --git a/payapi-spec/definitions.yaml b/payapi-spec/definitions.yaml
index 4ca2848..ed1adb4 100644
--- a/payapi-spec/definitions.yaml
+++ b/payapi-spec/definitions.yaml
@@ -8,6 +8,14 @@
       schema:
         type: string
 
+  responses:
+    CommonError:
+      description: 请求失败
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+
 
   schemas:
     ErrorResponse:
@@ -60,3 +68,36 @@
         - failed
         - already_success
         - require_query
+    UserStatus:
+      type: string
+      description: |
+        * normal 正常
+        * frozen 冻结
+        * canceled 注销
+        * closed 关闭
+        * notexists 不存在
+      enum:
+        - normal
+        - fronzen
+        - canceled
+        - closed
+        - notexists
+    SubAccountMetadata:
+      type: object
+      required:
+        - name
+        - status
+      properties:
+        name:
+          type: string
+          title: 子账户名
+        status:
+          title: 子账户状态
+          $ref: '#/components/schemas/UserStatus'
+        balance:
+          type: integer
+          title: 子账户余额
+        expire:
+          type: string
+          title: 余额有效期
+          format: date-time