✨ #1010 增加微信分账相关接口

* 微信单次分账接口

* - 微信多次分账
- 微信完结分账
- 添加分账接受方
- 删除分账接受方
- 查询分账结果【未能完成单元测试，微信返回签名失败】
- 分账回退【未能完成单元测试，使用真实数据返回“参数不正确”，我对比官方文档除了缺少`sub_mch_id`和`sub_appid`之外其他相同，当我随便填了一个商户id的时候，提示“回退方没有开通分账回退功能”】
- 回退结果查询【未能完成单元测试,因分账回退无法进行，模拟数据返回”记录不存在“】

Author: w22296437978

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingFinishRequest.java

@@ -0,0 +1,70 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.request.BaseWxPayRequest;
+import com.github.binarywang.wxpay.constant.WxPayConstants;
+import com.github.binarywang.wxpay.exception.WxPayException;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.*;
+import me.chanjar.weixin.common.annotation.Required;
+
+/**
+ * @author Wang GuangXin 2019/10/23 14:02
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Builder(builderMethodName = "newBuilder")
+@NoArgsConstructor
+@AllArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingFinishRequest extends BaseWxPayRequest {
+
+  private static final long serialVersionUID = -4265779954583596627L;
+
+  /**
+   * <pre>
+   * 字段名：微信订单号.
+   * 变量名：transaction_id
+   * 是否必填：是
+   * String(32)
+   * 示例值：4208450740201411110007820472
+   * 描述：微信支付订单号
+   * </pre>
+   */
+  @XStreamAlias("transaction_id")
+  @Required
+  private String transactionId;
+
+  /**
+   * <pre>
+   * 字段名：商户分账单号.
+   * 变量名：out_order_no
+   * 是否必填：是
+   * String(64)
+   * 示例值：P20150806125346
+   * 描述：商户系统内部的分账单号，在商户系统内部唯一（单次分账、多次分账、完结分账应使用不同的商户分账单号），同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@
+   * </pre>
+   */
+  @XStreamAlias("out_order_no")
+  @Required
+  private String outOrderNo;
+
+  /**
+   * <pre>
+   * 字段名：分账完结描述.
+   * 变量名：out_order_no
+   * 是否必填：是
+   * String(80)
+   * 示例值：分账已完成
+   * 描述：分账完结的原因描述
+   * </pre>
+   */
+  @XStreamAlias("description")
+  @Required
+  private String description;
+
+  @Override
+  protected void checkConstraints() throws WxPayException {
+    this.setSignType(WxPayConstants.SignType.HMAC_SHA256);
+  }
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingQueryRequest.java

@@ -0,0 +1,54 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.request.BaseWxPayRequest;
+import com.github.binarywang.wxpay.constant.WxPayConstants;
+import com.github.binarywang.wxpay.exception.WxPayException;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.*;
+import me.chanjar.weixin.common.annotation.Required;
+
+/**
+ * @author Wang GuangXin 2019/10/22 15:44
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Builder(builderMethodName = "newBuilder")
+@NoArgsConstructor
+@AllArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingQueryRequest extends BaseWxPayRequest {
+  private static final long serialVersionUID = 3566332883053157102L;
+  /**
+   * <pre>
+   * 字段名：微信支付订单号.
+   * 变量名：transaction_id
+   * 是否必填：是
+   * String(32)
+   * 示例值：4208450740201411110007820472
+   * 描述：微信支付订单号
+   * </pre>
+   */
+  @XStreamAlias("transaction_id")
+  @Required
+  private String transactionId;
+
+  /**
+   * <pre>
+   * 字段名：商户分账单号.
+   * 变量名：out_order_no
+   * 是否必填：是
+   * String(64)
+   * 示例值：P20150806125346
+   * 描述：查询分账结果，输入申请分账时的商户分账单号； 查询分账完结的执行结果，输入发起分账完结时的商户分账单号
+   * </pre>
+   */
+  @XStreamAlias("out_order_no")
+  @Required
+  private String outOrderNo;
+
+  @Override
+  protected void checkConstraints() throws WxPayException {
+    this.setSignType(WxPayConstants.SignType.HMAC_SHA256);
+  }
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingQueryResult.java

@@ -0,0 +1,114 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.result.BaseWxPayResult;
+import com.google.gson.FieldNamingPolicy;
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * @author Wang GuangXin 2019/10/22 15:51
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@NoArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingQueryResult extends BaseWxPayResult {
+  private static final long serialVersionUID = 2548673608075775067L;
+  /**
+   * 微信订单号
+   */
+  @XStreamAlias("transaction_id")
+  private String transactionId;
+  /**
+   * 商户分账单号
+   */
+  @XStreamAlias("out_order_no")
+  private String outOrderNo;
+  /**
+   * 微信分账单号
+   */
+  @XStreamAlias("orderId")
+  private String orderId;
+  /**
+   * 分账单状态
+   */
+  @XStreamAlias("status")
+  private String status;
+  /**
+   * 关单原因
+   */
+  @XStreamAlias("close_reason")
+  private String closeReason;
+  /**
+   * 分账接收方列表
+   */
+  @XStreamAlias("receivers")
+  private String receivers;
+  /**
+   * 分账金额
+   */
+  @XStreamAlias("amount")
+  private Integer amount;
+  /**
+   * 分账描述
+   */
+  @XStreamAlias("description")
+  private String description;
+
+  public ProfitSharingQueryResult.Receivers formatReceivers() {
+    GsonBuilder gsonBuilder = new GsonBuilder();
+    gsonBuilder.setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES);
+    Gson gson = gsonBuilder.create();
+    return gson.fromJson(receivers, Receivers.class);
+  }
+
+  @Data
+  public class Receivers {
+    /**
+     * 分账接收方类型
+     */
+    private String type;
+    /**
+     * 分账接收方帐号
+     */
+    private String account;
+    /**
+     * 分账金额
+     */
+    private Integer amount;
+    /**
+     * 分账描述
+     */
+    private String description;
+    /**
+     * 分账结果
+     */
+    private String result;
+    /**
+     * 分账完成时间
+     */
+    private String finishTime;
+    /**
+     * 分账失败原因
+     */
+    private String failReason;
+
+    @Override
+    public String toString() {
+      return "Receivers{" +
+        "type='" + type + '\'' +
+        ", account='" + account + '\'' +
+        ", amount=" + amount +
+        ", description='" + description + '\'' +
+        ", result='" + result + '\'' +
+        ", finishTime='" + finishTime + '\'' +
+        ", failReason='" + failReason + '\'' +
+        '}';
+    }
+  }
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingReceiverRequest.java

@@ -0,0 +1,47 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.request.BaseWxPayRequest;
+import com.github.binarywang.wxpay.constant.WxPayConstants;
+import com.github.binarywang.wxpay.exception.WxPayException;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.*;
+import me.chanjar.weixin.common.annotation.Required;
+
+/**
+ * 添加/删除分账接受方请求对象
+ *
+ * @author Wang GuangXin 2019/10/22 13:41
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Builder(builderMethodName = "newBuilder")
+@NoArgsConstructor
+@AllArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingReceiverRequest extends BaseWxPayRequest {
+  private static final long serialVersionUID = 2628263563539120323L;
+  /**
+   * <pre>
+   * 字段名：分账接收方.
+   * 变量名：receiver
+   * 是否必填：是
+   * String(2048)
+   * 示例值：{
+   *    "type": "MERCHANT_ID",
+   *    "account": "190001001",
+   *    "name": "示例商户全称",
+   *    "relation_type": "STORE_OWNER"
+   *    }
+   * 描述：分账接收方对象，json格式
+   * </pre>
+   */
+  @XStreamAlias("receiver")
+  @Required
+  private String receiver;
+
+  @Override
+  protected void checkConstraints() throws WxPayException {
+    this.setSignType(WxPayConstants.SignType.HMAC_SHA256);
+  }
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingReceiverResult.java

@@ -0,0 +1,25 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.request.BaseWxPayRequest;
+import com.github.binarywang.wxpay.bean.result.BaseWxPayResult;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * @author Wang GuangXin 2019/10/22 14:54
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@NoArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingReceiverResult extends BaseWxPayResult {
+  private static final long serialVersionUID = 876204163877798066L;
+  /**
+   * 分账接收方.
+   */
+  @XStreamAlias("receiver")
+  private String receiver;
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitsharingRequest.java renamed to weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingRequest.java

@@ -17,7 +17,7 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @XStreamAlias("xml")
-public class ProfitsharingRequest extends BaseWxPayRequest {
+public class ProfitSharingRequest extends BaseWxPayRequest {
   private static final long serialVersionUID = 212049937430575842L;
 
   /**

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/profitsharing/ProfitSharingReturnQueryRequest.java

@@ -0,0 +1,72 @@
+package com.github.binarywang.wxpay.bean.profitsharing;
+
+import com.github.binarywang.wxpay.bean.request.BaseWxPayRequest;
+import com.github.binarywang.wxpay.constant.WxPayConstants;
+import com.github.binarywang.wxpay.exception.WxPayException;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.*;
+import me.chanjar.weixin.common.annotation.Required;
+import org.apache.commons.lang3.StringUtils;
+
+/**
+ * @author Wang GuangXin 2019/10/23 15:32
+ * @version 1.0
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Builder(builderMethodName = "newBuilder")
+@NoArgsConstructor
+@AllArgsConstructor
+@XStreamAlias("xml")
+public class ProfitSharingReturnQueryRequest extends BaseWxPayRequest {
+  private static final long serialVersionUID = -8838464614726086009L;
+  /**
+   * <pre>
+   * 字段名：微信分账单号.
+   * 变量名：order_id
+   * 是否必填：二选一
+   * string(64)
+   * 示例值：3008450740201411110007820472
+   * 描述：原发起分账请求时，微信返回的微信分账单号，与商户分账单号一一对应。
+   * 微信分账单号与商户分账单号二选一填写
+   * </pre>
+   */
+  @XStreamAlias("order_id")
+  private String orderId;
+
+  /**
+   * <pre>
+   * 字段名：商户分账单号.
+   * 变量名：out_order_no
+   * 是否必填：二选一
+   * Sstring(64)
+   * 示例值：P20180806125346
+   * 描述：原发起分账请求时使用的商户后台系统的分账单号。
+   * 微信分账单号与商户分账单号二选一填写
+   * </pre>
+   */
+  @XStreamAlias("out_order_no")
+  private String outOrderNo;
+
+  /**
+   * <pre>
+   * 字段名：商户回退单号.
+   * 变量名：out_return_no
+   * 是否必填：是
+   * string(64)
+   * 示例值：R20190516001
+   * 描述：调用回退接口提供的商户系统内部的回退单号
+   * </pre>
+   */
+  @Required
+  @XStreamAlias("out_return_no")
+  private String outReturnNo;
+
+  @Override
+  protected void checkConstraints() throws WxPayException {
+    if (StringUtils.isBlank(orderId) && StringUtils.isBlank(outOrderNo)) {
+      throw new WxPayException("order_id 和 outOrderNo 必须有一个存在");
+    }
+    this.setSignType(WxPayConstants.SignType.HMAC_SHA256);
+  }
+}