🆕 #3494 【微信支付】平台收付通提现接口新增回调参数支持及补充日终余额提现API

Author: Copilot

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SpWithdrawRequest.java

@@ -9,7 +9,7 @@
 /**
  * 电商平台提现
  * <pre>
- *   文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/fund/chapter3_5.shtml
+ *   文档地址：https://pay.weixin.qq.com/doc/v3/partner/4012476670
  * </pre>
  */
 @Data
@@ -88,4 +88,19 @@ public class SpWithdrawRequest implements Serializable {
   @SerializedName(value = "account_type")
   private String accountType;
 
+  /**
+   * <pre>
+   * 字段名：回调通知地址
+   * 变量名：notify_url
+   * 是否必填：否
+   * 类型：string（256）
+   * 描述：
+   *  异步接收提现状态变更通知的回调地址，通知url必须为外网可访问的url，不能携带参数。
+   *  如果参数中传了notify_url，则商户平台上配置的回调地址将不会生效，优先回调当前传的地址。
+   * 示例值：https://www.weixin.qq.com/wxpay/pay.php
+   * </pre>
+   */
+  @SerializedName(value = "notify_url")
+  private String notifyUrl;
+
 }

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SubDayEndBalanceWithdrawRequest.java

@@ -0,0 +1,125 @@
+package com.github.binarywang.wxpay.bean.ecommerce;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 二级商户按日终余额预约提现
+ * <pre>
+ *   文档地址：https://pay.weixin.qq.com/doc/v3/partner/4013328143
+ * </pre>
+ *
+ * @author copilot
+ * created on  2024/12/24
+ */
+@Data
+@NoArgsConstructor
+public class SubDayEndBalanceWithdrawRequest implements Serializable {
+
+  private static final long serialVersionUID = -8745123456789012345L;
+
+  /**
+   * <pre>
+   * 字段名：二级商户号
+   * 变量名：sub_mchid
+   * 是否必填：是
+   * 类型：string（32）
+   * 描述：
+   *  电商平台二级商户号，由微信支付生成并下发。
+   * 示例值：1900000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchid;
+
+  /**
+   * <pre>
+   * 字段名：商户提现单号
+   * 变量名：out_request_no
+   * 是否必填：是
+   * 类型：string（32）
+   * 描述：
+   *  必须是字母数字
+   * 示例值：20190611222222222200000000012122
+   * </pre>
+   */
+  @SerializedName(value = "out_request_no")
+  private String outRequestNo;
+
+  /**
+   * <pre>
+   * 字段名：提现金额
+   * 变量名：amount
+   * 是否必填：是
+   * 类型：int64
+   * 描述：
+   *  提现金额（单位：分）
+   * 示例值：100
+   * </pre>
+   */
+  @SerializedName(value = "amount")
+  private Integer amount;
+
+  /**
+   * <pre>
+   * 字段名：备注
+   * 变量名：remark
+   * 是否必填：否
+   * 类型：string（56）
+   * 描述：
+   *  商户对提现单的备注
+   * 示例值：交易提现
+   * </pre>
+   */
+  @SerializedName(value = "remark")
+  private String remark;
+
+  /**
+   * <pre>
+   * 字段名：银行附言
+   * 变量名：bank_memo
+   * 是否必填：否
+   * 类型：string（32）
+   * 描述：
+   *  展示在收款银行系统中的附言，数字、字母最长32个汉字（能否成功展示依赖银行系统支持）。
+   * 示例值：微信支付提现
+   * </pre>
+   */
+  @SerializedName(value = "bank_memo")
+  private String bankMemo;
+
+  /**
+   * <pre>
+   * 字段名：出款账户类型
+   * 变量名：account_type
+   * 是否必填：是
+   * 类型：string（16）
+   * 描述：
+   *  枚举值：
+   *    BASIC：基本户
+   *    OPERATION：运营账户
+   *    FEES：手续费账户
+   * 示例值：BASIC
+   * </pre>
+   */
+  @SerializedName(value = "account_type")
+  private String accountType;
+
+  /**
+   * <pre>
+   * 字段名：回调通知地址
+   * 变量名：notify_url
+   * 是否必填：否
+   * 类型：string（256）
+   * 描述：
+   *  异步接收提现状态变更通知的回调地址，通知url必须为外网可访问的url，不能携带参数。
+   *  如果参数中传了notify_url，则商户平台上配置的回调地址将不会生效，优先回调当前传的地址。
+   * 示例值：https://www.weixin.qq.com/wxpay/pay.php
+   * </pre>
+   */
+  @SerializedName(value = "notify_url")
+  private String notifyUrl;
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SubDayEndBalanceWithdrawResult.java

@@ -0,0 +1,99 @@
+package com.github.binarywang.wxpay.bean.ecommerce;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 二级商户按日终余额预约提现结果
+ * <pre>
+ *   文档地址：https://pay.weixin.qq.com/doc/v3/partner/4013328143
+ * </pre>
+ *
+ * @author copilot
+ * created on  2024/12/24
+ */
+@Data
+@NoArgsConstructor
+public class SubDayEndBalanceWithdrawResult implements Serializable {
+
+  private static final long serialVersionUID = -8745123456789012346L;
+
+  /**
+   * <pre>
+   * 字段名：二级商户号
+   * 变量名：sub_mchid
+   * 是否必填：是
+   * 类型：string（32）
+   * 描述：
+   *  电商平台二级商户号，由微信支付生成并下发。
+   * 示例值：1900000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchid;
+
+  /**
+   * <pre>
+   * 字段名：电商平台商户号
+   * 变量名：sp_mchid
+   * 是否必填：是
+   * 类型：string（32）
+   * 描述：
+   *  电商平台商户号
+   * 示例值：1800000123
+   * </pre>
+   */
+  @SerializedName(value = "sp_mchid")
+  private String spMchid;
+
+  /**
+   * <pre>
+   * 字段名：商户提现单号
+   * 变量名：out_request_no
+   * 是否必填：是
+   * 类型：string（32）
+   * 描述：
+   *  商户提现单号，由商户自定义生成。
+   * 示例值：20190611222222222200000000012122
+   * </pre>
+   */
+  @SerializedName(value = "out_request_no")
+  private String outRequestNo;
+
+  /**
+   * <pre>
+   * 字段名：微信支付提现单号
+   * 变量名：withdraw_id
+   * 是否必填：是
+   * 类型：string（128）
+   * 描述：
+   *  电商平台提交二级商户提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。
+   * 示例值：12321937198237912739132791732912793127931279317929791239112123
+   * </pre>
+   */
+  @SerializedName(value = "withdraw_id")
+  private String withdrawId;
+
+  /**
+   * <pre>
+   * 字段名：提现单状态
+   * 变量名：status
+   * 是否必填：是
+   * 类型：string（16）
+   * 描述：
+   *  枚举值：
+   *  CREATE_SUCCESS：受理成功
+   *  SUCCESS：提现成功
+   *  FAIL：提现失败
+   *  REFUND：提现退票
+   *  CLOSE：关单
+   *  INIT：业务单已创建
+   * 示例值：CREATE_SUCCESS
+   * </pre>
+   */
+  @SerializedName(value = "status")
+  private String status;
+}