🎨 【微信支付】特约商户进件接口根据官方文档调整进行更新

jeequan · binarywang · commit f19ef3b0976a · 2022-07-05T02:08:18.000Z
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/ModifySettlementRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/ModifySettlementRequest.java
@@ -26,6 +26,12 @@ public class ModifySettlementRequest implements Serializable {
    */
   @SerializedName("account_type")
   private AccountTypeEnum accountType;
+  /**
+   * 开户名称
+   */
+  @SpecEncrypt
+  @SerializedName("account_name")
+  private String accountName;
   /**
    * 开户银行
    */
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/WxPayApplyment4SubCreateRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/WxPayApplyment4SubCreateRequest.java
@@ -64,7 +64,7 @@ public class WxPayApplyment4SubCreateRequest implements Serializable {
   private BankAccountInfo bankAccountInfo;
 
   /**
-   * 结算银行账户
+   * 补充材料
    */
   @SerializedName("addition_info")
   private AdditionInfo additionInfo;
@@ -80,13 +80,40 @@ public class WxPayApplyment4SubCreateRequest implements Serializable {
   public static class ContactInfo implements Serializable {
     private static final long serialVersionUID = 1L;
 
+    /**
+     * 超级管理员类型
+     * 1、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：LEGAL：经营者/法人，SUPER：经办人 。（经办人：经商户授权办理微信支付业务的人员）。
+     * 枚举值：
+     * LEGAL：经营者/法人
+     * SUPER：经办人
+     * 示例值：LEGAL
+     */
+    @SerializedName("contact_type")
+    private String contactType;
+
     /**
      * 超级管理员姓名
      */
     @SerializedName("contact_name")
     @SpecEncrypt
     private String contactName;
 
+    /**
+     * 超级管理员证件类型
+     * 当超级管理员类型是经办人时，请上传超级管理员证件类型。
+     * IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证
+     * IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照
+     * IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证
+     * IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证
+     * IDENTIFICATION_TYPE_TAIWAN_PASSPORT：中国台湾居民-来往大陆通行证
+     * IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证
+     * IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证
+     * IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证
+     * 示例值：IDENTIFICATION_TYPE_IDCARD
+     */
+    @SerializedName("contact_id_doc_type")
+    private String contactIdDocType;
+
     /**
      * 超级管理员身份证件号码
      * 1、“超级管理员身份证号码”与“超级管理员微信openid”，二选一必填。
@@ -97,6 +124,58 @@ public static class ContactInfo implements Serializable {
     @SpecEncrypt
     private String contactIdNumber;
 
+    /**
+     * 超级管理员证件正面照片
+     * 1、当超级管理员类型是经办人时，请上传超级管理员证件的正面照片。
+     * 2、若证件类型为身份证，请上传人像面照片。
+     * 3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     * 4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     * 示例值：jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ
+     */
+    @SerializedName("contact_id_doc_copy")
+    private String contactIdDocCopy;
+
+    /**
+     * 超级管理员证件反面照片
+     * 1、当超级管理员类型是经办人时，请上传超级管理员证件的反面照片。
+     * 2、若证件类型为护照，无需上传反面照片。
+     * 3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     * 4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     * 示例值：jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
+     */
+    @SerializedName("contact_id_doc_copy_back")
+    private String contactIdDocCopyBack;
+
+    /**
+     * 超级管理员证件有效期开始时间
+     * 1、当超级管理员类型是经办人时，请上传证件有效期开始时间。
+     * 2、请按照示例值填写。
+     * 3、结束时间大于开始时间。
+     * 示例值：2019-06-06
+     */
+    @SerializedName("contact_period_begin")
+    private String contactPeriodBegin;
+
+    /**
+     * 超级管理员证件有效期结束时间
+     * 1、当超级管理员类型是经办人时，请上传证件有效期结束时间。
+     * 2、请按照示例值填写，若证件有效期为长期，请填写：长期。
+     * 3、结束时间大于开始时间。
+     * 示例值：2026-06-06
+     */
+    @SerializedName("contact_period_end")
+    private String contactPeriodEnd;
+
+    /**
+     * 业务办理授权函
+     * 1、当超级管理员类型是经办人时，请上传业务办理授权函。
+     * 2、请参照[示例图]打印业务办理授权函，全部信息需打印，不支持手写商户信息，并加盖公章。
+     * 3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     * 示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     */
+    @SerializedName("business_authorization_letter")
+    private String businessAuthorizationLetter;
+
     /**
      * 超级管理员微信openid
      * 1、“超级管理员身份证件号码”与“超级管理员微信openid”，二选一必填。
@@ -140,6 +219,12 @@ public static class SubjectInfo implements Serializable {
     @SerializedName("subject_type")
     private SubjectTypeEnum subjectType;
 
+    /**
+     * 是否是金融机构
+     */
+    @SerializedName("finance_institution")
+    private boolean financeInstitution;
+
     /**
      * 营业执照
      */
@@ -171,11 +256,11 @@ public static class SubjectInfo implements Serializable {
     private IdentityInfo identityInfo;
 
     /**
-     * 最终受益人信息(UBO]
+     * 最终受益人信息列表(UBO)
      */
-    @SerializedName("ubo_info")
+    @SerializedName("ubo_info_list")
     @SpecEncrypt
-    private UboInfo uboInfo;
+    private List<UboInfo> uboInfoList;
 
     /**
      * 小微辅助证明材料（subjectType为小微商户时必填）
@@ -210,6 +295,21 @@ public static class BusinessLicenseInfo implements Serializable {
        */
       @SerializedName("legal_person")
       private String legalPerson;
+      /**
+       * 注册地址
+       */
+      @SerializedName("license_address")
+      private String licenseAddress;
+      /**
+       * 有效期限开始日期
+       */
+      @SerializedName("period_begin")
+      private String periodBegin;
+      /**
+       * 有效期限结束日期
+       */
+      @SerializedName("period_end")
+      private String periodEnd;
     }
 
     @Data
@@ -255,7 +355,7 @@ public static class CertificateInfo implements Serializable {
 
 
       /**
-       * 法人姓名
+       * 法定代表人
        */
       @SerializedName("legal_person")
       private String legalPerson;
@@ -314,12 +414,24 @@ public static class OrganizationInfo implements Serializable {
     public static class IdentityInfo implements Serializable {
       private static final long serialVersionUID = 1683704338370383827L;
 
+      /**
+       * 证件持有人类型
+       */
+      @SerializedName("id_holder_type")
+      private IdTypeEnum idHolderType;
+
       /**
        * 证件类型
        */
       @SerializedName("id_doc_type")
       private IdTypeEnum idDocType;
 
+      /**
+       * 法定代表人说明函
+       */
+      @SerializedName("authorize_letter_copy")
+      private IdTypeEnum authorizeLetterCopy;
+
       /**
        * 身份证信息
        */
@@ -357,7 +469,6 @@ public static class IdCardInfo implements Serializable {
          */
         @SerializedName("id_card_national")
         private String idCardNational;
-
         /**
          * 身份证姓名
          */
@@ -370,6 +481,12 @@ public static class IdCardInfo implements Serializable {
         @SerializedName("id_card_number")
         @SpecEncrypt
         private String idCardNumber;
+        /**
+         * 身份证居住地址
+         */
+        @SerializedName("id_card_address")
+        @SpecEncrypt
+        private String idCardAddress;
         /**
          * 身份证有效期开始时间
          */
@@ -391,10 +508,15 @@ public static class IdCardInfo implements Serializable {
       public static class IdDocInfo implements Serializable {
         private static final long serialVersionUID = 7335589815924447719L;
         /**
-         * 证件照片
+         * 证件正面照片
          */
         @SerializedName("id_doc_copy")
         private String idDocCopy;
+        /**
+         * 证件反面照片
+         */
+        @SerializedName("id_doc_copy_back")
+        private String idDocCopyBack;
 
         /**
          * 证件姓名
@@ -409,6 +531,12 @@ public static class IdDocInfo implements Serializable {
         @SerializedName("id_doc_number")
         @SpecEncrypt
         private String idDocNumber;
+        /**
+         * 身份证居住地址
+         */
+        @SerializedName("id_card_address")
+        @SpecEncrypt
+        private String idCardAddress;
         /**
          * 证件有效期开始时间
          */
@@ -432,45 +560,46 @@ public static class UboInfo implements Serializable {
       /**
        * 证件类型
        */
-      @SerializedName("id_type")
-      private IdTypeEnum idType;
+      @SerializedName("ubo_id_doc_type")
+      private IdTypeEnum uboIdDocType;
       /**
-       * 身份证人像面照片
+       * 证件正面照片
        */
-      @SerializedName("id_card_copy")
-      private String idCardCopy;
+      @SerializedName("ubo_id_doc_copy")
+      private String uboIdDocCopy;
       /**
-       * 身份证国徽面照片
+       * 证件反面照片
        */
-      @SerializedName("id_card_national")
-      private String idCardNational;
+      @SerializedName("ubo_id_doc_copy_back")
+      private String uboIdDocCopyBack;
       /**
-       * 证件照片
+       * 证件姓名
        */
-      @SerializedName("id_doc_copy")
-      private String idDocCopy;
+      @SerializedName("ubo_id_doc_name")
+      @SpecEncrypt
+      private String uboIdDocName;
       /**
-       * 受益人姓名
+       * 证件号码
        */
-      @SerializedName("name")
+      @SerializedName("ubo_id_doc_number")
       @SpecEncrypt
-      private String name;
+      private String uboIdDocNumber;
       /**
-       * 证件号码
+       * 证件居住地址
        */
-      @SerializedName("id_number")
+      @SerializedName("ubo_id_doc_address")
       @SpecEncrypt
-      private String idNumber;
+      private String uboIdDocAddress;
       /**
        * 证件有效期开始时间
        */
-      @SerializedName("id_period_begin")
-      private String idPeriodBegin;
+      @SerializedName("ubo_period_begin")
+      private String uboPeriodBegin;
       /**
        * 证件有效期结束时间
        */
-      @SerializedName("id_period_end")
-      private String idPeriodEnd;
+      @SerializedName("ubo_period_end")
+      private String uboPeriodEnd;
     }
 
     @Data
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/enums/CertTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/enums/CertTypeEnum.java
@@ -40,14 +40,6 @@ public enum CertTypeEnum {
    * 基金会法人登记证书
    */
   CERTIFICATE_TYPE_2396,
-  /**
-   * 慈善组织公开募捐资格证书
-   */
-  CERTIFICATE_TYPE_2397,
-  /**
-   * 农民专业合作社法人营业执照
-   */
-  CERTIFICATE_TYPE_2398,
   /**
    * 宗教活动场所登记证
    */
@@ -56,5 +48,17 @@ public enum CertTypeEnum {
    * 其他证书/批文/证明
    */
   CERTIFICATE_TYPE_2400,
+  /**
+   * 执业许可证/执业证
+   */
+  CERTIFICATE_TYPE_2520,
+  /**
+   * 基层群众性自治组织特别法人统一社会信用代码证
+   */
+  CERTIFICATE_TYPE_2521,
+  /**
+   * 农村集体经济组织登记证
+   */
+  CERTIFICATE_TYPE_2522,
   ;
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/enums/IdTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/applyment/enums/IdTypeEnum.java
@@ -25,5 +25,17 @@ public enum IdTypeEnum {
    * 中国台湾居民-来往大陆通行证
    */
   IDENTIFICATION_TYPE_TAIWAN_PASSPORT,
+  /**
+   * 外国人居留证
+   */
+  IDENTIFICATION_TYPE_FOREIGN_RESIDENT,
+  /**
+   * 港澳居民证
+   */
+  IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT,
+  /**
+   * 台湾居民证
+   */
+  IDENTIFICATION_TYPE_TAIWAN_RESIDENT,
   ;
 }
