U: docs/v3/profitsharing/*

TheNorthMemory · TheNorthMemory · commit 0fb056841198 · 2025-10-09T19:13:44.000+08:00
diff --git a/docs/v3/profitsharing/bills.yaml b/docs/v3/profitsharing/bills.yaml
@@ -1,13 +1,13 @@
 get:
-  x-last-updated-at: 2025.01.20
+  x-last-updated-at: 2025.09.29
   x-role:
     - 直连商户
     - 电商平台
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 申请分账账单API
-  description: 微信支付按天提供分账账单文件，商户可以通过该接口获取账单文件的下载地址。文件内包含分账相关的金额、时间等信息，供商户核对到账等情况。[官方文档](https://pay.weixin.qq.com/doc/v3/merchant/4012529628) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012761140) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012715572) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012715572) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012715572) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012715572) [官方文档](https://pay.weixin.qq.com/doc/v3/partner/4012715572) [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_11.shtml)
+  summary: 申请分账账单
+  description: 微信支付按天提供分账账单文件，商户可以通过该接口获取账单文件的下载地址。文件内包含分账相关的金额、时间等信息，供商户核对到账等情况。
   parameters:
     - name: sub_mchid
       in: query
@@ -45,6 +45,8 @@ get:
             type: string
             description: 哈希类型
             example: SHA1
+            enum:
+              - SHA1
           hash_value:
             type: string
             description: 哈希值
diff --git a/docs/v3/profitsharing/merchant-configs/{sub_mchid}.yaml b/docs/v3/profitsharing/merchant-configs/{sub_mchid}.yaml
@@ -1,11 +1,11 @@
 get:
-  x-last-updated-at: 2021.05.11
+  x-last-updated-at: 2025.09.29
   x-role:
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 查询最大分账比例API
-  description: 可调用此接口查询特约商户设置的允许服务商分账的最大比例 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_7.shtml)
+  summary: 查询最大分账比例
+  description: 可调用此接口查询特约商户设置的允许服务商分账的最大比例
   parameters:
     - name: sub_mchid
       in: path
diff --git a/docs/v3/profitsharing/orders.yaml b/docs/v3/profitsharing/orders.yaml
@@ -1,11 +1,12 @@
 post:
-  x-last-updated-at: 2022.06.14
+  x-last-updated-at: 2025.09.29
   x-role:
+    - 直连商户
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 请求分账API
-  description: 微信订单支付成功后，服务商代特约商户发起分账请求，将结算后的资金分到分账接收方 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_1.shtml)
+  summary: 请求分账
+  description: 微信订单支付成功后，服务商代特约商户发起分账请求，将结算后的资金分到分账接收方
   parameters:
     - $ref: '../../definitions/Parameters.yaml#/HTTP_WECHATPAY_SERIAL'
     - name: _
@@ -14,7 +15,6 @@ post:
       schema:
         type: object
         required:
-          - appid
           - transaction_id
           - out_order_no
           - unfreeze_unsplit
@@ -54,6 +54,10 @@ post:
                   type: string
                   description: 分账接收方类型
                   example: MERCHANT_ID
+                  enum:
+                    - MERCHANT_ID
+                    - PERSONAL_OPENID
+                    - PERSONAL_SUB_OPENID
                 account:
                   type: string
                   description: 分账接收方帐号
@@ -104,6 +108,9 @@ post:
             type: string
             description: 分账单状态
             example: FINISHED
+            enum:
+              - PROCESSING
+              - FINISHED
           receivers:
             type: array
             description: 分账接收方列表
@@ -115,7 +122,6 @@ post:
                 - type
                 - account
                 - result
-                - fail_reason
                 - create_time
                 - finish_time
               properties:
@@ -131,6 +137,10 @@ post:
                   type: string
                   description: 分账接收方类型
                   example: MERCHANT_ID
+                  enum:
+                    - MERCHANT_ID
+                    - PERSONAL_OPENID
+                    - PERSONAL_SUB_OPENID
                 account:
                   type: string
                   description: 分账接收方帐号
@@ -139,19 +149,34 @@ post:
                   type: string
                   description: 分账结果
                   example: SUCCESS
+                  enum:
+                    - PENDING
+                    - SUCCESS
+                    - CLOSED
                 fail_reason:
                   type: string
                   description: 分账失败原因
                   example: ACCOUNT_ABNORMAL
+                  enum:
+                    - ACCOUNT_ABNORMAL #分账接收账户异常
+                    - NO_RELATION #分账关系已解除
+                    - RECEIVER_HIGH_RISK #高风险接收方
+                    - RECEIVER_REAL_NAME_NOT_VERIFIED #接收方未实名
+                    - NO_AUTH #分账权限已解除
+                    - RECEIVER_RECEIPT_LIMIT #超出用户月收款限额
+                    - PAYER_ACCOUNT_ABNORMAL #分出方账户异常
+                    - INVALID_REQUEST #描述参数设置失败
                 detail_id:
                   type: string
                   description: 分账明细单号
                   example: '36011111111111111111111'
                 create_time:
                   type: string
+                  format: rfc3339
                   description: 分账创建时间
                   example: '2015-05-20T13:29:35.120+08:00'
                 finish_time:
                   type: string
+                  format: rfc3339
                   description: 分账完成时间
                   example: '2015-05-20T13:29:35.120+08:00'
diff --git a/docs/v3/profitsharing/orders/unfreeze.yaml b/docs/v3/profitsharing/orders/unfreeze.yaml
@@ -1,11 +1,12 @@
 post:
-  x-last-updated-at: 2021.05.11
+  x-last-updated-at: 2025.09.29
   x-role:
+    - 直连商户
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 解冻剩余资金API
-  description: 不需要进行分账的订单，可直接调用本接口将订单的金额全部解冻给特约商户 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_5.shtml)
+  summary: 解冻剩余资金
+  description: 不需要进行分账的订单，可直接调用本接口将订单的金额全部解冻给特约商户
   parameters:
     - name: _
       in: body
@@ -63,6 +64,9 @@ post:
             type: string
             description: 分账单状态
             example: FINISHED
+            enum:
+              - PROCESSING
+              - FINISHED
           receivers:
             type: array
             description: 分账接收方列表
@@ -90,6 +94,10 @@ post:
                   type: string
                   description: 分账接收方类型
                   example: MERCHANT_ID
+                  enum:
+                    - MERCHANT_ID
+                    - PERSONAL_OPENID
+                    - PERSONAL_SUB_OPENID
                 account:
                   type: string
                   description: 分账接收方帐号
@@ -102,15 +110,26 @@ post:
                   type: string
                   description: 分账失败原因
                   example: ACCOUNT_ABNORMAL
+                  enum:
+                    - ACCOUNT_ABNORMAL #分账接收账户异常
+                    - NO_RELATION #分账关系已解除
+                    - RECEIVER_HIGH_RISK #高风险接收方
+                    - RECEIVER_REAL_NAME_NOT_VERIFIED #接收方未实名
+                    - NO_AUTH #分账权限已解除
+                    - RECEIVER_RECEIPT_LIMIT #超出用户月收款限额
+                    - PAYER_ACCOUNT_ABNORMAL #分出方账户异常
+                    - INVALID_REQUEST #描述参数设置失败
                 detail_id:
                   type: string
                   description: 分账明细单号
                   example: '36011111111111111111111'
                 create_time:
                   type: string
+                  format: rfc3339
                   description: 分账创建时间
                   example: '2015-05-20T13:29:35.120+08:00'
                 finish_time:
                   type: string
+                  format: rfc3339
                   description: 分账完成时间
                   example: '2015-05-20T13:29:35.120+08:00'
diff --git a/docs/v3/profitsharing/orders/{out_order_no}.yaml b/docs/v3/profitsharing/orders/{out_order_no}.yaml
@@ -1,11 +1,12 @@
 get:
-  x-last-updated-at: 2021.05.11
+  x-last-updated-at: 2025.09.29
   x-role:
+    - 直连商户
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 查询分账结果API
-  description: 发起分账请求后，可调用此接口查询分账结果 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_2.shtml)
+  summary: 查询分账结果
+  description: 发起分账请求后，可调用此接口查询分账结果
   parameters:
     - name: sub_mchid
       in: query
@@ -14,11 +15,13 @@ get:
       example: '1900000109'
     - name: transaction_id
       in: query
+      required: true
       type: string
       description: 微信订单号
       example: '4208450740201411110007820472'
     - name: out_order_no
       in: path
+      required: true
       type: string
       description: 商户分账单号
       example: P20150806125346
@@ -52,6 +55,10 @@ get:
             type: string
             description: 分账单状态
             example: FINISHED
+            enum:
+              - PENDING
+              - SUCCESS
+              - CLOSED
           receivers:
             type: array
             description: 分账接收方列表
@@ -63,7 +70,6 @@ get:
                 - type
                 - account
                 - result
-                - fail_reason
                 - create_time
                 - finish_time
               properties:
@@ -79,6 +85,10 @@ get:
                   type: string
                   description: 分账接收方类型
                   example: MERCHANT_ID
+                  enum:
+                    - MERCHANT_ID
+                    - PERSONAL_OPENID
+                    - PERSONAL_SUB_OPENID
                 account:
                   type: string
                   description: 分账接收方帐号
@@ -87,6 +97,15 @@ get:
                   type: string
                   description: 分账结果
                   example: SUCCESS
+                  enum:
+                    - ACCOUNT_ABNORMAL #分账接收账户异常
+                    - NO_RELATION #分账关系已解除
+                    - RECEIVER_HIGH_RISK #高风险接收方
+                    - RECEIVER_REAL_NAME_NOT_VERIFIED #接收方未实名
+                    - NO_AUTH #分账权限已解除
+                    - RECEIVER_RECEIPT_LIMIT #超出用户月收款限额
+                    - PAYER_ACCOUNT_ABNORMAL #分出方账户异常
+                    - INVALID_REQUEST #描述参数设置失败
                 fail_reason:
                   type: string
                   description: 分账失败原因
@@ -97,9 +116,11 @@ get:
                   example: '36011111111111111111111'
                 create_time:
                   type: string
+                  format: rfc3339
                   description: 分账创建时间
                   example: '2015-05-20T13:29:35.120+08:00'
                 finish_time:
                   type: string
+                  format: rfc3339
                   description: 分账完成时间
                   example: '2015-05-20T13:29:35.120+08:00'
diff --git a/docs/v3/profitsharing/receivers/add.yaml b/docs/v3/profitsharing/receivers/add.yaml
@@ -1,11 +1,12 @@
 post:
-  x-last-updated-at: 2021.05.11
+  x-last-updated-at: 2025.09.29
   x-role:
+    - 直连商户
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 添加分账接收方API
-  description: 服务商发起添加分账接收方请求，建立分账接收方列表。后续可通过发起分账请求，将分账方商户结算后的资金，分到该分账接收方 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_8.shtml)
+  summary: 添加分账接收方
+  description: 服务商发起添加分账接收方请求，建立分账接收方列表。后续可通过发起分账请求，将分账方商户结算后的资金，分到该分账接收方
   parameters:
     - $ref: '../../../definitions/Parameters.yaml#/HTTP_WECHATPAY_SERIAL'
     - name: _
@@ -35,6 +36,10 @@ post:
             type: string
             description: 分账接收方类型
             example: MERCHANT_ID
+            enum:
+              - MERCHANT_ID
+              - PERSONAL_OPENID
+              - PERSONAL_SUB_OPENID
           account:
             type: string
             description: 分账接收方帐号
@@ -81,6 +86,10 @@ post:
             type: string
             description: 分账接收方类型
             example: MERCHANT_ID
+            enum:
+              - MERCHANT_ID
+              - PERSONAL_OPENID
+              - PERSONAL_SUB_OPENID
           account:
             type: string
             description: 分账接收方账号
@@ -94,6 +103,18 @@ post:
             type: string
             description: 与分账方的关系类型
             example: SERVICE_PROVIDER
+            enum:
+              - SERVICE_PROVIDER #服务商
+              - STORE #门店
+              - STAFF #员工
+              - STORE_OWNER #店主
+              - PARTNER #合作伙伴
+              - HEADQUARTER #总部
+              - BRAND #品牌方
+              - DISTRIBUTOR #分销商
+              - USER #用户
+              - SUPPLIER #供应商
+              - CUSTOM #自定义
           custom_relation:
             type: string
             description: 自定义的分账关系
diff --git a/docs/v3/profitsharing/receivers/delete.yaml b/docs/v3/profitsharing/receivers/delete.yaml
@@ -1,11 +1,12 @@
 post:
-  x-last-updated-at: 2021.05.11
+  x-last-updated-at: 2025.09.29
   x-role:
+    - 直连商户
     - 服务商
   tags:
     - 资金应用∙分账
-  summary: 删除分账接收方API
-  description: 服务商发起删除分账接收方请求。删除后，不支持将分账方商户结算后的资金，分到该分账接收方 [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter8_1_9.shtml)
+  summary: 删除分账接收方
+  description: 服务商发起删除分账接收方请求。删除后，不支持将分账方商户结算后的资金，分到该分账接收方
   parameters:
     - name: _
       in: body
@@ -33,6 +34,10 @@ post:
             type: string
             description: 分账接收方类型
             example: MERCHANT_ID
+            enum:
+              - MERCHANT_ID
+              - PERSONAL_OPENID
+              - PERSONAL_SUB_OPENID
           account:
             type: string
             description: 分账接收方账号
@@ -53,6 +58,10 @@ post:
             type: string
             description: 分账接收方类型
             example: MERCHANT_ID
+            enum:
+              - MERCHANT_ID
+              - PERSONAL_OPENID
+              - PERSONAL_SUB_OPENID
           account:
             type: string
             description: 分账接收方账号
diff --git a/docs/v3/profitsharing/return-orders.yaml b/docs/v3/profitsharing/return-orders.yaml
diff --git a/docs/v3/profitsharing/return-orders/{out_return_no}.yaml b/docs/v3/profitsharing/return-orders/{out_return_no}.yaml
diff --git a/docs/v3/profitsharing/transactions/{transaction_id}/amounts.yaml b/docs/v3/profitsharing/transactions/{transaction_id}/amounts.yaml
