U: src/V3/Global_/*

TheNorthMemory · TheNorthMemory · commit 974b3243cd27 · 2025-04-17T22:05:24.000+08:00
diff --git a/docs/v3/global/papay/contracts/web-pre-entrust-sign.yaml b/docs/v3/global/papay/contracts/web-pre-entrust-sign.yaml
@@ -1,12 +1,12 @@
 post:
-  x-last-updated-at: 2021.12.08
+  x-last-updated-at: 2025.04.01
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境∙代扣
   summary: WEB预签约API
-  description: 该方式适用于PC等使用浏览器的设备场景使用微信签约扣款。商户在网站后端通过微信支付WEB签约接口获取到签约链接，在网站前端将签约链接生成二维码，引导用户扫码识别该链接，用户访问该链接进入代扣签约页面；用户签约完成后留在微信。WEB 端等待签约回调通知，或者定时轮询查询用户签约状态，更新页面内容。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter5_1_16.shtml)
+  description: 该方式适用于PC等使用浏览器的设备场景使用微信签约扣款。商户在网站后端通过微信支付WEB签约接口获取到签约链接，在网站前端将签约链接生成二维码，引导用户扫码识别该链接，用户访问该链接进入代扣签约页面；用户签约完成后留在微信。WEB 端等待签约回调通知，或者定时轮询查询用户签约状态，更新页面内容。
   parameters:
     - name: _
       in: body
@@ -55,14 +55,18 @@ post:
             format: rfc3339
             description: 过期时间
             example: '2021-11-20T13:29:35+08:00'
+          return_url:
+            type: string
+            description: 签约完成跳转URL
+            example: https://pay.weixin.qq.com
   responses:
     '200':
       schema:
         type: object
         required:
-          - sign_url
+          - show_code_url
         properties:
-          sign_url:
+          show_code_url:
             type: string
-            description: 签约跳转URL
-            example: https://apihk.mch.weixin.qq.com/global/papay/contracts/login?os_session_id=2021120910391616228#wechat_redirect
+            description: 展码页面URL
+            example: https://osapp.pay.weixin.qq.com/global/papay/contracts/sessions/show_code?os_session_id=2025032811X0100X5371319501
diff --git a/docs/v3/global/refunds.yaml b/docs/v3/global/refunds.yaml
@@ -1,12 +1,12 @@
 post:
-  x-last-updated-at: 2022.08.04
+  x-last-updated-at: 2025.03.03
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境∙退款
   summary: 申请退款
-  description: 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账号上。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter5_1_11.shtml)
+  description: 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账号上。
   parameters:
     - name: _
       in: body
@@ -141,6 +141,7 @@ post:
                     description: 汇率类型
                     example: SETTLEMENT_RATE
                     enum:
+                      - USERPAYMENT_RATE
                       - SETTLEMENT_RATE
                   rate:
                     type: integer
@@ -184,14 +185,14 @@ post:
                 description: 货币类型
                 example: CNY
 get:
-  x-last-updated-at: 2022.08.04
+  x-last-updated-at: 2025.03.03
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境∙退款
   summary: 查询所有退款
-  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter5_1_13.shtml)
+  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
   parameters:
     - name: transaction_id
       in: query
@@ -382,6 +383,7 @@ get:
                           description: 汇率类型
                           example: SETTLEMENT_RATE
                           enum:
+                            - USERPAYMENT_RATE
                             - SETTLEMENT_RATE
                         rate:
                           type: integer
diff --git a/docs/v3/global/refunds/id/{refund_id}.yaml b/docs/v3/global/refunds/id/{refund_id}.yaml
@@ -1,12 +1,12 @@
 get:
-  x-last-updated-at: 2022.08.04
+  x-last-updated-at: 2025.03.27
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境∙退款
   summary: 查询单笔退款(微信支付退款订单号)
-  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter5_1_12.shtml)
+  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
   parameters:
     - name: mchid
       in: query
@@ -131,6 +131,7 @@ get:
                     description: 汇率类型
                     example: SETTLEMENT_RATE
                     enum:
+                      - USERPAYMENT_RATE
                       - SETTLEMENT_RATE
                   rate:
                     type: integer
diff --git a/docs/v3/global/refunds/out-refund-no/{out_refund_no}.yaml b/docs/v3/global/refunds/out-refund-no/{out_refund_no}.yaml
@@ -1,12 +1,12 @@
 get:
-  x-last-updated-at: 2022.08.04
+  x-last-updated-at: 2025.03.27
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境∙退款
   summary: 查询单笔退款(商户退款订单号)
-  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter5_1_12.shtml)
+  description: 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
   parameters:
     - name: mchid
       in: query
@@ -132,6 +132,7 @@ get:
                     description: 汇率类型
                     example: SETTLEMENT_RATE
                     enum:
+                      - USERPAYMENT_RATE
                       - SETTLEMENT_RATE
                   rate:
                     type: integer
diff --git a/docs/v3/global/statements.yaml b/docs/v3/global/statements.yaml
@@ -1,12 +1,12 @@
 get:
-  x-last-updated-at: 2022.08.04
+  x-last-updated-at: 2025.01.07
   x-role:
     - 直连模式
     - 机构模式
   tags:
     - 跨境
   summary: 下载对账单
-  description: 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。 [官方文档](https://pay.weixin.qq.com/wiki/doc/api_external/ch/apis/chapter3_1_6.shtml)
+  description: 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。
   parameters:
     - name: date
       in: query
@@ -19,7 +19,16 @@ get:
       type: string
       description: 商户号
       example: '1900000109'
-    - $ref: '../../definitions/Parameters.yaml#/HTTP_ACCEPT_ENCODING'
+    - name: sp_mchid
+      in: query
+      type: string
+      description: 机构商户号
+      example: '1900000100'
+    - name: sub_mchid
+      in: query
+      type: string
+      description: 子商户号
+      example: '1900000109'
   responses:
     '200':
       headers:
diff --git a/src/V3/Global_/Papay/Contracts/WebPreEntrustSign.php b/src/V3/Global_/Papay/Contracts/WebPreEntrustSign.php
@@ -27,6 +27,7 @@ public function post(array $options = [
             'user_display_name' => '张三',
             'success_notify_url' => 'https://pay.weixin.qq.com',
             'expired_time' => '2021-11-20T13:29:35+08:00',
+            'return_url' => 'https://pay.weixin.qq.com',
         ],
     ]): ResponseInterface;
 
@@ -48,6 +49,7 @@ public function postAsync(array $options = [
             'user_display_name' => '张三',
             'success_notify_url' => 'https://pay.weixin.qq.com',
             'expired_time' => '2021-11-20T13:29:35+08:00',
+            'return_url' => 'https://pay.weixin.qq.com',
         ],
     ]): PromiseInterface;
 }
diff --git a/src/V3/Global_/Statements.php b/src/V3/Global_/Statements.php
@@ -19,9 +19,8 @@ public function get(array $options = [
         'query' => [
             'date' => '20180130',
             'mchid' => '1900000109',
-        ],
-        'headers' => [
-            'Accept-Encoding' => 'gzip',
+            'sp_mchid' => '1900000100',
+            'sub_mchid' => '1900000109',
         ],
     ]): ResponseInterface;
 
@@ -35,9 +34,8 @@ public function getAsync(array $options = [
         'query' => [
             'date' => '20180130',
             'mchid' => '1900000109',
-        ],
-        'headers' => [
-            'Accept-Encoding' => 'gzip',
+            'sp_mchid' => '1900000100',
+            'sub_mchid' => '1900000109',
         ],
     ]): PromiseInterface;
 }
