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

2025-12-15 19:47:58 +08:00 · 2022-07-05 02:08:18 +00:00
parent a17d8ae5a2
commit f19ef3b097
4 changed files with 188 additions and 37 deletions
--- 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;
  /**
   * 开户银行
   */
--- 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,6 +80,17 @@ 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;
+
    /**
     * 超级管理员姓名
     */
@@ -87,6 +98,22 @@ public class WxPayApplyment4SubCreateRequest implements Serializable {
    @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 class WxPayApplyment4SubCreateRequest 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 class WxPayApplyment4SubCreateRequest implements Serializable {
    @SerializedName("subject_type")
    private SubjectTypeEnum subjectType;

+    /**
+     * 是否是金融机构
+     */
+    @SerializedName("finance_institution")
+    private boolean financeInstitution;
+
    /**
     * 营业执照
     */
@@ -171,11 +256,11 @@ public class WxPayApplyment4SubCreateRequest 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 class WxPayApplyment4SubCreateRequest 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 class WxPayApplyment4SubCreateRequest implements Serializable {


      /**
-       * 法人姓名
+       * 法定代表人
       */
      @SerializedName("legal_person")
      private String legalPerson;
@@ -314,12 +414,24 @@ public class WxPayApplyment4SubCreateRequest 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 class WxPayApplyment4SubCreateRequest implements Serializable {
         */
        @SerializedName("id_card_national")
        private String idCardNational;
-
        /**
         * 身份证姓名
         */
@@ -370,6 +481,12 @@ public class WxPayApplyment4SubCreateRequest implements Serializable {
        @SerializedName("id_card_number")
        @SpecEncrypt
        private String idCardNumber;
+        /**
+         * 身份证居住地址
+         */
+        @SerializedName("id_card_address")
+        @SpecEncrypt
+        private String idCardAddress;
        /**
         * 身份证有效期开始时间
         */
@@ -391,10 +508,15 @@ public class WxPayApplyment4SubCreateRequest 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 class WxPayApplyment4SubCreateRequest implements Serializable {
        @SerializedName("id_doc_number")
        @SpecEncrypt
        private String idDocNumber;
+        /**
+         * 身份证居住地址
+         */
+        @SerializedName("id_card_address")
+        @SpecEncrypt
+        private String idCardAddress;
        /**
         * 证件有效期开始时间
         */
@@ -432,45 +560,46 @@ public class WxPayApplyment4SubCreateRequest 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("name")
+      @SerializedName("ubo_id_doc_name")
      @SpecEncrypt
-      private String name;
+      private String uboIdDocName;
      /**
       * 证件号码
       */
-      @SerializedName("id_number")
+      @SerializedName("ubo_id_doc_number")
      @SpecEncrypt
-      private String idNumber;
+      private String uboIdDocNumber;
+      /**
+       * 证件居住地址
+       */
+      @SerializedName("ubo_id_doc_address")
+      @SpecEncrypt
+      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
--- 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,
  ;
 }
--- 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,
  ;
 }