U: v2/*profitsharing*/* enums

TheNorthMemory · Nov 26, 2024 · d5568bf · d5568bf
1 parent 9e93ddb
commit d5568bf
Show file tree

Hide file tree

Showing 33 changed files with 93 additions and 52 deletions.
diff --git a/docs/definitions/deletecontract.yaml b/docs/definitions/deletecontract.yaml
@@ -50,6 +50,8 @@ deletecontract.request:
           type: string
           description: 版本号
           example: '1.0'
+          enum:
+            - '1.0'
 deletecontract.response:
   allOf:
     - type: object

diff --git a/docs/definitions/facepay.yaml b/docs/definitions/facepay.yaml
@@ -3,10 +3,8 @@ facepay.request:
   xml:
     name: xml
   required:
-    - deposit
     - appid
     - mch_id
-    - sub_mch_id
     - nonce_str
     - sign
     - body
@@ -22,6 +20,9 @@ facepay.request:
       description: 是否押金支付
       example: 'Y'
       maxLength: 1
+      enum:
+        - Y
+        - N
     appid:
       type: string
       description: 公众账号ID
@@ -211,9 +212,7 @@ facepay.response:
         name: xml
       required:
         - appid
-        - sub_appid
         - mch_id
-        - sub_mch_id
         - nonce_str
         - sign
         - result_code

diff --git a/docs/definitions/micro.modifyarchives.yaml b/docs/definitions/micro.modifyarchives.yaml
@@ -18,6 +18,8 @@ micro.modifyarchives.request:
           description: 接口版本号
           example: '1.0'
           maxLength: 32
+          enum:
+            - '1.0'
         mch_id:
           type: string
           description: 商户号
@@ -135,9 +137,6 @@ micro.modifyarchives.response:
     - type: object
       xml:
         name: xml
-      required:
-        - mch_id
-        - sub_mch_id
       properties:
         mch_id:
           type: string

diff --git a/docs/definitions/micro.modifycontactinfo.yaml b/docs/definitions/micro.modifycontactinfo.yaml
@@ -9,14 +9,15 @@ micro.modifycontactinfo.request:
         - nonce_str
         - sign_type
         - sign
-        - sub_mch_id
         - cert_sn
       properties:
         version:
           type: string
           description: 接口版本号
           example: '1.0'
           maxLength: 32
+          enum:
+            - '1.0'
         mch_id:
           type: string
           description: 商户号
@@ -130,9 +131,6 @@ micro.modifycontactinfo.response:
     - type: object
       xml:
         name: xml
-      required:
-        - mch_id
-        - sub_mch_id
       properties:
         mch_id:
           type: string

diff --git a/docs/definitions/micro.submit.yaml b/docs/definitions/micro.submit.yaml
@@ -37,6 +37,8 @@ micro.submit.request:
           description: 接口版本号
           example: '3.0'
           maxLength: 32
+          enum:
+            - '3.0'
         cert_sn:
           type: string
           description: 平台证书序列号

diff --git a/docs/definitions/micro.submitupgrade.yaml b/docs/definitions/micro.submitupgrade.yaml
@@ -28,6 +28,8 @@ micro.submitupgrade.request:
           description: 接口版本号
           example: '1.0'
           maxLength: 32
+          enum:
+            - '1.0'
         mch_id:
           type: string
           description: 商户号

diff --git a/docs/definitions/multiprofitsharing.yaml b/docs/definitions/multiprofitsharing.yaml
@@ -5,18 +5,13 @@ multiprofitsharing.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - appid
         - nonce_str
         - sign
         - sign_type
         - transaction_id
         - out_order_no
         - receivers
-        - type
-        - account
-        - amount
-        - description
       properties:
         mch_id:
           type: string
@@ -183,3 +178,7 @@ multiprofitsharing.response:
                 result:
                   type: string
                   description: 分账结果
+                  enum:
+                    - PENDING #待分账
+                    - SUCCESS #分账成功
+                    - CLOSED #分账失败已关闭
diff --git a/docs/definitions/orderquery.yaml b/docs/definitions/orderquery.yaml
@@ -15,6 +15,8 @@ orderquery.request:
       description: 接口版本号
       example: '1.0'
       maxLength: 32
+      enum:
+        - '1.0'
     appid:
       type: string
       description: 公众账号ID

diff --git a/docs/definitions/profitsharing.yaml b/docs/definitions/profitsharing.yaml
@@ -5,18 +5,13 @@ profitsharing.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - appid
         - nonce_str
         - sign
         - sign_type
         - transaction_id
         - out_order_no
         - receivers
-        - type
-        - account
-        - amount
-        - description
       properties:
         mch_id:
           type: string
@@ -203,3 +198,7 @@ profitsharing.response:
                 result:
                   type: string
                   description: 分账结果
+                  enum:
+                    - PENDING #待分账
+                    - SUCCESS #分账成功
+                    - CLOSED #分账失败已关闭
diff --git a/docs/definitions/profitsharingaddreceiver.yaml b/docs/definitions/profitsharingaddreceiver.yaml
@@ -5,7 +5,6 @@ profitsharingaddreceiver.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - appid
         - nonce_str
         - sign

diff --git a/docs/definitions/profitsharingfinish.yaml b/docs/definitions/profitsharingfinish.yaml
@@ -5,7 +5,6 @@ profitsharingfinish.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - appid
         - nonce_str
         - sign

diff --git a/docs/definitions/profitsharingquery.yaml b/docs/definitions/profitsharingquery.yaml
@@ -5,7 +5,6 @@ profitsharingquery.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - transaction_id
         - out_order_no
         - nonce_str
@@ -90,14 +89,11 @@ profitsharingquery.response:
         status:
           type: string
           description: 分账单状态
-          example: SUCCESS
+          example: FINISHED
           maxLength: 16
-        close_reason:
-          type: string
-          description: 关单原因
-          example: NO_AUTH
-          maxLength: 32
-          nullable: true
+          enum:
+            - PROCESSING
+            - FINISHED
         receivers:
           type: string
           description: 分账接收方列表`JSON`格式字符串
@@ -148,3 +144,7 @@ profitsharingquery.response:
                 result:
                   type: string
                   description: 分账结果
+                  enum:
+                    - PENDING #待分账
+                    - SUCCESS #分账成功
+                    - CLOSED #分账失败已关闭
diff --git a/docs/definitions/profitsharingremovereceiver.yaml b/docs/definitions/profitsharingremovereceiver.yaml
@@ -5,14 +5,11 @@ profitsharingremovereceiver.request:
         name: xml
       required:
         - mch_id
-        - sub_mch_id
         - appid
         - nonce_str
         - sign
         - sign_type
         - receiver
-        - type
-        - account
       properties:
         mch_id:
           type: string

diff --git a/docs/definitions/query_coupon_stock.yaml b/docs/definitions/query_coupon_stock.yaml
@@ -50,12 +50,16 @@ query_coupon_stock.request:
       example: '1.0'
       maxLength: 32
       nullable: true
+      enum:
+        - '1.0'
     type:
       type: string
       description: 协议类型
       example: XML
       maxLength: 32
       nullable: true
+      enum:
+        - XML
 query_coupon_stock.response:
   type: object
   xml:

diff --git a/docs/definitions/querycontract.yaml b/docs/definitions/querycontract.yaml
@@ -41,6 +41,8 @@ querycontract.request:
           type: string
           description: 版本号
           example: '1.0'
+          enum:
+            - '1.0'
         sign:
           type: string
           description: 签名

diff --git a/docs/definitions/querycouponsinfo.yaml b/docs/definitions/querycouponsinfo.yaml
@@ -61,12 +61,16 @@ querycouponsinfo.request:
       example: '1.0'
       maxLength: 32
       nullable: true
+      enum:
+        - '1.0'
     type:
       type: string
       description: 协议类型
       example: XML
       maxLength: 32
       nullable: true
+      enum:
+        - XML
 querycouponsinfo.response:
   type: object
   xml:

diff --git a/docs/definitions/send_coupon.yaml b/docs/definitions/send_coupon.yaml
@@ -66,12 +66,16 @@ send_coupon.request:
       example: '1.0'
       maxLength: 32
       nullable: true
+      enum:
+        - '1.0'
     type:
       type: string
       description: 协议类型
       example: XML
       maxLength: 32
       nullable: true
+      enum:
+        - XML
 send_coupon.response:
   type: object
   xml:

diff --git a/docs/definitions/unifiedorder.yaml b/docs/definitions/unifiedorder.yaml
@@ -19,6 +19,8 @@ unifiedorder.request:
       description: 接口版本号
       example: '1.0'
       maxLength: 32
+      enum:
+        - '1.0'
     profit_sharing:
       type: string
       description: 是否指定服务商分账;Y-是，需要分账;N-否，不分账;字母要求大写，不传默认不分账
@@ -195,6 +197,9 @@ unifiedorder.request:
       example: 'Y'
       maxLength: 8
       nullable: true
+      enum:
+        - Y
+        - N
     scene_info:
       xml:
         x-cdata: true

diff --git a/docs/v2/face/get_wxpayface_authinfo.yaml b/docs/v2/face/get_wxpayface_authinfo.yaml
@@ -132,7 +132,6 @@ post:
               - sign
               - appid
               - mch_id
-              - sub_mch_id
             properties:
               authinfo:
                 type: string

diff --git a/docs/v2/mmpaymkttransfers/sendredpack.yaml b/docs/v2/mmpaymkttransfers/sendredpack.yaml
@@ -3,7 +3,7 @@ post:
   tags:
     - APIv2∙资金应用∙红包
   summary: 发放普通红包
-  description: 现金红包发放后会以公众号消息的形式触达用户，不同情况下触达消息的形式会有差别，相关规则如下：1.已关注公众号的用户，使用“防伪消息”触达；2.未关注公众号的用户，使用“模板消息”触达。[官方文档](https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3)
+  description: 现金红包发放后会以公众号消息的形式触达用户，不同情况下触达消息的形式会有差别，相关规则如下：1.已关注公众号的用户，使用“防伪消息”触达；2.未关注公众号的用户，使用“模板消息”触达。[官方文档](https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon_sl.php?chapter=13_4&index=3) [官方文档](https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3)
   consumes:
     - application/xml
   produces:
@@ -51,6 +51,16 @@ post:
             description: 商户号
             example: '10000098'
             maxLength: 32
+          sub_mch_id:
+            type: string
+            description: 子商户号
+            example: '10000090'
+            maxLength: 32
+          msgappid:
+            type: string
+            description: 触达用户appid
+            example: wx8888888888888888
+            maxLength: 32
           wxappid:
             type: string
             description: 公众账号appid

diff --git a/docs/v2/pay/partner/preentrustweb.yaml b/docs/v2/pay/partner/preentrustweb.yaml
@@ -20,7 +20,6 @@ post:
         required:
           - appid
           - mch_id
-          - sub_mch_id
           - plan_id
           - contract_code
           - request_serial
@@ -69,6 +68,8 @@ post:
             type: string
             description: 版本号
             example: '1.0'
+            enum:
+              - '1.0'
           sign_type:
             type: string
             description: 签名类型

diff --git a/docs/v2/pay/partner/querycontract.yaml b/docs/v2/pay/partner/querycontract.yaml
@@ -20,7 +20,6 @@ post:
         required:
           - appid
           - mch_id
-          - sub_mch_id
           - version
           - sign
         properties:
@@ -56,6 +55,8 @@ post:
             type: string
             description: 版本号
             example: '1.0'
+            enum:
+              - '1.0'
           sign:
             type: string
             description: 签名

diff --git a/docs/v2/pay/profitsharingaddreceiver.yaml b/docs/v2/pay/profitsharingaddreceiver.yaml
@@ -2,7 +2,7 @@ post:
   tags:
     - APIv2∙资金应用∙分账
   summary: 添加分账接收方
-  description: '服务商代子商户发起添加分账接收方请求，后续可通过发起分账请求将结算后的钱分到该分账接收方。[官方文档](https://pay.weixin.qq.com/wiki/doc/api/allocation_sl.php?chapter=25_3&index=4)'
+  description: '服务商代子商户发起添加分账接收方请求，后续可通过发起分账请求将结算后的钱分到该分账接收方。[官方文档](https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=27_3&index=4) [官方文档](https://pay.weixin.qq.com/wiki/doc/api/allocation_sl.php?chapter=25_3&index=4)'
   consumes:
     - application/xml
   produces: