From a21a622936c97801ef20a6c5866adea83cdecfb0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8B=B1=E7=8B=90?= Date: Tue, 14 Jun 2022 02:30:33 +0000 Subject: [PATCH] =?UTF-8?q?:new:=20#2696=20=E3=80=90=E5=BE=AE=E4=BF=A1?= =?UTF-8?q?=E6=94=AF=E4=BB=98=E3=80=91=E9=93=B6=E8=A1=8C=E7=BB=84=E4=BB=B6?= =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E7=9C=81=E5=B8=82=E5=88=97=E8=A1=A8=E6=9F=A5?= =?UTF-8?q?=E8=AF=A2=E5=8F=8A=E6=94=AF=E8=A1=8C=E5=88=97=E8=A1=A8=E6=9F=A5?= =?UTF-8?q?=E8=AF=A2=E7=9A=84=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../wxpay/bean/bank/BankBranchesResult.java | 176 ++++ .../wxpay/bean/bank/CitiesResult.java | 80 ++ .../binarywang/wxpay/bean/bank/PageLink.java | 62 ++ .../wxpay/bean/bank/ProvincesResult.java | 81 ++ .../bean/ecommerce/ApplymentsRequest.java | 780 ++++++++++++++---- .../binarywang/wxpay/service/BankService.java | 58 +- .../wxpay/service/EcommerceService.java | 2 +- .../wxpay/service/impl/BankServiceImpl.java | 26 +- 8 files changed, 1109 insertions(+), 156 deletions(-) create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/BankBranchesResult.java create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/CitiesResult.java create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/PageLink.java create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/ProvincesResult.java diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/BankBranchesResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/BankBranchesResult.java new file mode 100644 index 000000000..72cc4f6a7 --- /dev/null +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/BankBranchesResult.java @@ -0,0 +1,176 @@ +package com.github.binarywang.wxpay.bean.bank; + +import com.google.gson.annotations.SerializedName; +import lombok.Data; +import lombok.Getter; +import lombok.Setter; + +import java.io.Serializable; +import java.util.List; + +/** + * 支行列表 + * + * @author hupeng + **/ +@Data +public class BankBranchesResult implements Serializable { + + private static final long serialVersionUID = -3500020131951579476L; + + /** + * 
+   * 字段名：查询数据总条数
+   * 变量名：total_count
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  经过条件筛选，查询到的支行总数
+   *  示例值：10
+   *
+ */ + @SerializedName("total_count") + private Integer totalCount; + + /** + * 
+   * 字段名：本次查询条数
+   * 变量名：count
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  本次查询到的支行数据条数
+   *  示例值：10
+   *
+ */ + @SerializedName("count") + private Integer count; + + /** + * 
+   * 字段名：支行列表
+   * 变量名：data
+   * 是否必填：否
+   * 类型：array
+   * 描述：
+   *  单次查询返回的支行列表结果数组
+   *
+ */ + @SerializedName("data") + private List data; + + /** + * 
+   * 字段名：本次查询偏移量
+   * 变量名：offset
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  该次请求资源的起始位置，请求中包含偏移量时应答消息返回相同偏移量，否则返回默认值0
+   *  示例值：0
+   *
+ */ + @SerializedName("offset") + private Integer offset; + + /** + * 
+   * 字段名：分页链接
+   * 变量名：offset
+   * 是否必填：是
+   * 类型：object
+   * 描述：
+   *  返回前后页和当前页面的访问链接
+   *
+ */ + @SerializedName("links") + private PageLink links; + + /** + * 
+   * 字段名：开户银行
+   * 变量名：account_bank
+   * 是否必填：是
+   * 类型：string[1, 128]
+   * 描述：
+   *  查询到的支行所属开户银行的名称，非直连银行统一为其他银行
+   *  示例值：招商银行其他银行
+   *
+ */ + @SerializedName("account_bank") + private String accountBank; + + /** + * 
+   * 字段名：开户银行编码
+   * 变量名：account_bank_code
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  查询到的支行所属开户银行的开户银行编码，可用于付款到银行卡等场景中指定银行卡的开户银行
+   *  示例值：1001
+   *
+ */ + @SerializedName("account_bank_code") + private Integer accountBankCode; + + /** + * 
+   * 字段名：银行别名
+   * 变量名：bank_alias
+   * 是否必填：是
+   * 类型：string[1, 128]
+   * 描述：
+   *  查询到的支行所属银行的银行别名
+   *  示例值：工商银行深圳前海微众银行
+   *
+ */ + @SerializedName("bank_alias") + private String bankAlias; + + /** + * 
+   * 字段名：银行别名编码
+   * 变量名：bank_alias_code
+   * 是否必填：是
+   * 类型：string[1, 32]
+   * 描述：
+   *  查询到的支行所属银行的银行别名编码，用于校验回包
+   *  示例值：1000006247
+   *
+ */ + @SerializedName("bank_alias_code") + private String bankAliasCode; + + @Getter + @Setter + public static class BankBranch { + /** + * 
+     * 字段名：开户银行支行名称
+     * 变量名：bank_branch_name
+     * 是否必填：是
+     * 类型：string[1, 128]
+     * 描述：
+     *  开户银行支行名称，用于开户银行为其他银行的情况下，在入驻、修改结算银行卡、企业付款等场景下填写结算银行卡信息。
+     *  示例值：中国工商银行上海市周浦支行
+     *
+ */ + @SerializedName("bank_branch_name") + private String bankBranchName; + + /** + * 
+     * 字段名：开户银行支行联行号
+     * 变量名：bank_branch_id
+     * 是否必填：是
+     * 类型：string[1, 64]
+     * 描述：
+     *  开户银行支行的联行号，用于开户银行为其他银行的情况下，在入驻、修改结算银行卡、企业付款等场景下填写结算银行卡信息。
+     *  示例值：102290072311
+     *
+ */ + @SerializedName("bank_branch_id") + private String bankBranchId; + } +} diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/CitiesResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/CitiesResult.java new file mode 100644 index 000000000..b5bf87c81 --- /dev/null +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/CitiesResult.java @@ -0,0 +1,80 @@ +package com.github.binarywang.wxpay.bean.bank; + +import com.google.gson.annotations.SerializedName; +import lombok.Data; +import lombok.Getter; +import lombok.Setter; + +import java.io.Serializable; +import java.util.List; + +/** + * 城市列表 + * + * @author hupeng + **/ +@Data +public class CitiesResult implements Serializable { + + private static final long serialVersionUID = -6089905695087974693L; + + /** + * 
+   * 字段名：查询数据总条数
+   * 变量名：total_count
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  查询到的省份数据总条数
+   *  示例值：10
+   *
+ */ + @SerializedName("total_count") + private Integer totalCount; + + /** + * 
+   * 字段名：城市列表
+   * 变量名：data
+   * 是否必填：否
+   * 类型：array
+   * 描述：
+   *  查询返回的城市列表结果
+   *
+ */ + @SerializedName("data") + private List data; + + @Getter + @Setter + public static class CityInfo { + /** + * 
+     * 字段名：城市名称
+     * 变量名：city_name
+     * 是否必填：是
+     * 类型：string[1, 256]
+     * 描述：
+     *  城市名称
+     *  示例值：北京市
+     *
+ */ + @SerializedName("city_name") + private String cityName; + + /** + * 
+     * 字段名：城市编码
+     * 变量名：city_code
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  城市编码，唯一标识一座城市，用于结合银行别名编码查询支行列表
+     *  示例值：10
+     *
+ */ + @SerializedName("city_code") + private Integer cityCode; + } + +} diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/PageLink.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/PageLink.java new file mode 100644 index 000000000..419cdc3c9 --- /dev/null +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/PageLink.java @@ -0,0 +1,62 @@ +package com.github.binarywang.wxpay.bean.bank; + +import com.google.gson.annotations.SerializedName; +import lombok.Data; +import lombok.Getter; +import lombok.Setter; + +import java.io.Serializable; +import java.util.List; + +/** + * 支行列表 + * + * @author hupeng + **/ +@Data +public class PageLink implements Serializable { + + private static final long serialVersionUID = -2624233403271204837L; + + /** + * 
+   * 字段名：下一页链接
+   * 变量名：next
+   * 是否必填：否
+   * 类型：string[1, 2048]
+   * 描述：
+   *  使用同样的limit进行下一页查询时的相对请求链接，使用方需要自行根据当前域名进行拼接。如果已经到最后时，为空
+   *  示例值：/v3/capital/capitallhh/banks/1001/branches?offset=10&limit=5
+   *
+ */ + @SerializedName("next") + private String next; + + /** + * 
+   * 字段名：上一页链接
+   * 变量名：prev
+   * 是否必填：否
+   * 类型：string[1, 2048]
+   * 描述：
+   *  使用同样的limit进行上一页查询时的相对请求链接，使用方需要自行根据当前域名进行拼接。如果是第一页，为空
+   *  示例值：/v3/capital/capitallhh/banks/1001/branchesoffset=0&limit=5
+   *
+ */ + @SerializedName("prev") + private String prev; + + /** + * 
+   * 字段名：当前链接
+   * 变量名：self
+   * 是否必填：否
+   * 类型：string[1, 2048]
+   * 描述：
+   *  当前的相对请求链接，使用方需要自行根据当前域名进行拼接
+   *  示例值：/v3/capital/capitallhh/banks/1001/branches?offset=5&limit=5
+   *
+ */ + @SerializedName("self") + private String self; +} diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/ProvincesResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/ProvincesResult.java new file mode 100644 index 000000000..6525fc1c9 --- /dev/null +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/bank/ProvincesResult.java @@ -0,0 +1,81 @@ +package com.github.binarywang.wxpay.bean.bank; + +import com.google.gson.annotations.SerializedName; +import lombok.Data; +import lombok.Getter; +import lombok.Setter; + +import java.io.Serializable; +import java.util.List; + +/** + * 省份列表 + * + * @author hupeng + **/ +@Data +public class ProvincesResult implements Serializable { + + private static final long serialVersionUID = -4118613374545722650L; + + /** + * 
+   * 字段名：查询数据总条数
+   * 变量名：total_count
+   * 是否必填：是
+   * 类型：int
+   * 描述：
+   *  查询到的省份数据总条数
+   *  示例值：10
+   *
+ */ + @SerializedName("total_count") + private Integer totalCount; + + /** + * 
+   * 字段名：省份列表
+   * 变量名：data
+   * 是否必填：否
+   * 类型：array
+   * 描述：
+   *  查询到的省份列表数组
+   *
+ */ + @SerializedName("data") + private List data; + + @Getter + @Setter + public static class ProvinceInfo { + + /** + * 
+     * 字段名：省份名称
+     * 变量名：province_name
+     * 是否必填：是
+     * 类型：string[1, 256]
+     * 描述：
+     *  省份名称
+     *  示例值：广东省
+     *
+ */ + @SerializedName("province_name") + private String provinceName; + + /** + * 
+     * 字段名：省份编码
+     * 变量名：province_code
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  省份编码，唯一标识一个省份，用于根据省份编码查询省份下的城市列表数据
+     *  示例值：22
+     *
+ */ + @SerializedName("province_code") + private Integer provinceCode; + } + +} diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/ApplymentsRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/ApplymentsRequest.java index 87ce9b5b2..9b0c6b660 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/ApplymentsRequest.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/ApplymentsRequest.java @@ -6,12 +6,13 @@ import lombok.Data; import lombok.NoArgsConstructor; import java.io.Serializable; +import java.util.List; /** * 
  * 电商平台，可使用该接口，帮助其二级商户进件成为微信支付商户。
- * 文档地址:https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_1.shtml
+ * 文档地址:https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_1_8.shtml
  *
*/ @Data @@ -41,18 +42,37 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(4) * 描述： - * 枚举值： - * 2401：小微商户，指无营业执照的商户。 + * 非小微的主体类型需与营业执照/登记证书上一致，可参考选择主体指引，枚举值如下。 + * 2401：小微商户，指无营业执照的个人商家。 + * 2500：个人卖家，指无营业执照，已持续从事电子商务经营活动满6个月，且期间经营收入累计超过20万元的个人商家。（若选择该主体，请在“补充说明”填写相关描述）。 * 4：个体工商户，营业执照上的主体类型一般为个体户、个体工商户、个体经营。 * 2：企业，营业执照上的主体类型一般为有限公司、有限责任公司。 - * 3：党政、机关及事业单位，包括国内各级、各类政府机构、事业单位等（如：公安、党团、司法、交通、旅游、工商税务、市政、医疗、教育、学校等机构）。 - * 1708：其他组织，不属于企业、政府/事业单位的组织机构（如社会团体、民办非企业、基金会），要求机构已办理组织机构代码证。 - * 示例值：2401 + * 3：事业单位，包括国内各类事业单位，如：医疗、教育、学校等单位。 + * 2502：政府机关，包括各级、各类政府机关，如机关党委、税务、民政、人社、工商、商务、市监等。 + * 1708：社会组织，包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织。 + * 示例值：2 * */ @SerializedName(value = "organization_type") private String organizationType; + /** + * 
+   * 字段名：是否金融机构
+   * 变量名：finance_institution
+   * 是否必填：条件选填
+   * 类型：bool
+   * 描述：
+   *  选填，请根据申请主体的实际情况填写，可参考选择金融机构指引：
+   *  1、若商户主体是金融机构，则填写：true。
+   *  2、若商户主体不是金融机构，则填写：false。
+   *  若未传入将默认填写：false。
+   *  示例值：true
+   *
+ */ + @SerializedName(value = "finance_institution") + private Boolean financeInstitution; + /** * 
    * 字段名：+营业执照/登记证书信息
@@ -60,9 +80,9 @@ public class ApplymentsRequest implements Serializable {
    * 是否必填：条件选填
    * 类型：object
    * 描述：
-   *  1、主体为“小微”时，不填。
+   *  1、主体为“小微/个人卖家”时，不填。
    *  2、主体为“个体工商户/企业”时，请上传营业执照。
-   *  3、主体为“党政、机关及事业单位/其他组织”时，请上传登记证书。
+   *  3、主体为“政府机关/事业单位/社会组织”时，请上传登记证书。
    *
*/ @SerializedName(value = "business_license_info") @@ -70,38 +90,75 @@ public class ApplymentsRequest implements Serializable { /** * 
-   * 字段名：+组织机构代码证信息
-   * 变量名：organization_cert_info
+   * 字段名：+金融机构许可证信息
+   * 变量名：finance_institution_info
    * 是否必填：条件选填
    * 类型：object
-   * 描述：主体为企业/党政、机关及事业单位/其他组织，且证件号码不是18位时必填。
+   * 描述：当主体是金融机构时，必填
    *
*/ - @SerializedName(value = "organization_cert_info") - private OrganizationCertInfo organizationCertInfo; + @SerializedName(value = "finance_institution_info") + private FinanceInstitutionInfo financeInstitutionInfo; + + /** + * 字段名：证件持有人类型 + * 变量名：id_holder_type + * 是否必填：条件选填 + * 类型：string + * 描述： + * 1. 主体类型为政府机关/事业单位时选传： + * （1）若上传的是法人证件，则不需要上传该字段。 + * （2）若因特殊情况，无法提供法人证件时，可上传经办人。 （经办人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。 + * 2. 主体类型为企业/个体户/社会组织时，默认为经营者/法人，不需要上传该字段。 + * LEGAL：法人 + * SUPER：经办人 + * 示例值：LEGAL + */ + @SerializedName(value = "id_holder_type") + private String idHolderType; /** * 
    * 字段名：经营者/法人证件类型
    * 变量名：id_doc_type
-   * 是否必填：否
+   * 是否必填：条件选填
    * 类型：string(64)
    * 描述：
-   *  1、主体为“小微”，只可选择：身份证。
-   *  2、主体为“个体户/企业/党政、机关及事业单位/其他组织”，可选择：任一证件类型。
-   *  3、若没有填写，系统默认选择：身份证。
-   *  枚举值:
+   *  1、当证件持有人类型为经营者/法人时，需要填写。其他情况，无需上传。
+   *  2、主体为“小微/个人卖家”，可选择：身份证。
+   *  3、主体为“个体户/企业/事业单位/社会组织”：可选择任一证件类型，主体为“政府机关”仅支持中国大陆居民-身份证类型。
+   *  4、若没有填写，系统默认选择：身份证。
+   *  枚举值：
    *  IDENTIFICATION_TYPE_MAINLAND_IDCARD：中国大陆居民-身份证
    *  IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照
-   *  IDENTIFICATION_TYPE_HONGKONG：中国香港居民–来往内地通行证
-   *  IDENTIFICATION_TYPE_MACAO：中国澳门居民–来往内地通行证
-   *  IDENTIFICATION_TYPE_TAIWAN：中国台湾居民–来往大陆通行证
-   *  示例值：IDENTIFICATION_TYPE_MACAO
+   *  IDENTIFICATION_TYPE_HONGKONG：中国香港居民--来往内地通行证
+   *  IDENTIFICATION_TYPE_MACAO：中国澳门居民--来往内地通行证
+   *  IDENTIFICATION_TYPE_TAIWAN：中国台湾居民--来往大陆通行证
+   *  IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证
+   *  IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证
+   *  IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证
+   *  示例值：IDENTIFICATION_TYPE_MAINLAND_IDCARD
    *
*/ @SerializedName(value = "id_doc_type") private String idDocType; + /** + * 
+   * 字段名：法定代表人说明函
+   * 变量名：authorize_letter_copy
+   * 是否必填：条件选填
+   * 类型：string(256)
+   * 描述：
+   *  1、当证件持有人类型为经办人时，必须上传。其他情况，无需上传。
+   *  2、若因特殊情况，无法提供法定代表人证件时，请参照示例图打印法定代表人说明函，全部信息需打印，不支持手写商户信息，并加盖公章。
+   *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+   *  示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+   *
+ */ + @SerializedName(value = "authorize_letter_copy") + private String authorizeLetterCopy; + /** * 
    * 字段名：+经营者/法人身份证信息
@@ -109,8 +166,7 @@ public class ApplymentsRequest implements Serializable {
    * 是否必填：条件选填
    * 类型：object
    * 描述：
-   *  请填写经营者/法人的身份证信息
-   *  证件类型为“身份证”时填写。
+   *  当证件持有人类型为经营者/法人且证件类型为“身份证”时填写。
    *
    *
*/ @@ -124,7 +180,7 @@ public class ApplymentsRequest implements Serializable { * 变量名：id_doc_info * 是否必填：条件选填 * 类型：object - * 描述：证件类型为“来往内地通行证、来往大陆通行证、护照”时填写。 + * 描述：当证件持有人类型为经营者/法人且证件类型不为“身份证”时填写。 * */ @SerializedName(value = "id_doc_info") @@ -146,27 +202,31 @@ public class ApplymentsRequest implements Serializable { /** * 
-   * 字段名：是否填写结算账户信息
-   * 变量名：need_account_info
-   * 是否必填：是
+   * 字段名：最终受益人信息列表
+   * 变量名：ubo_info_list
+   * 是否必填：条件选填
    * 类型：bool
    * 描述：
-   *  可根据实际情况，填写“true”或“false”。
-   *  1、若为“true”，则需填写结算账户信息。
-   *  2、若为“false”，则无需填写结算账户信息。
-   *  示例值：true
+   *  仅企业需要填写。
+   *  若经营者/法人不是最终受益所有人，则需提填写受益所有人信息，最多上传4个。
+   *  若经营者/法人是最终受益所有人之一，可在此填写其他受益所有人信息，最多上传3个。
+   *  根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一：
+   *  1、直接或者间接拥有超过25%公司股权或者表决权的自然人。
+   *  2、通过人事、财务等其他方式对公司进行控制的自然人。
+   *  3、公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。
    *
*/ - @SerializedName(value = "need_account_info") - private Boolean needAccountInfo; + @SerializedName(value = "ubo_info_list") + @SpecEncrypt + private List uboInfoList; /** * 
    * 字段名：+结算账户信息
    * 变量名：account_info
-   * 是否必填：条件选填
+   * 是否必填：是
    * 类型：object
-   * 描述：若"是否填写结算账户信息"填写为“true”, 则必填，填写为“false”不填 。
+   * 描述：请填写商家提现收款的银行账户信息
    *
*/ @SerializedName(value = "account_info") @@ -219,7 +279,7 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(64) * 描述： - * UTF-8格式，中文占3个字节，即最多16个汉字长度。将在支付完成页向买家展示，需与商家的实际售卖商品相符 。 + * UTF-8格式，中文占3个字节，即最多21个汉字长度。将在支付完成页向买家展示，需与商家的实际售卖商品相符 。 * 示例值：腾讯 * */ @@ -233,9 +293,10 @@ public class ApplymentsRequest implements Serializable { * 是否必填：否 * 类型：string(1024) * 描述： - * 1、若店铺业务包含互联网售药，则需上传特殊资质-《互联网药品交易服务证》。 - * 2、最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 - * 示例值：[\"jTpGmxUX3FBWVQ5NJInE4d2I6_H7I4\"] + * 1、根据商户经营业务要求提供相关资质，详情查看《行业对应特殊资质》。 + * 2、请提供为“申请商家主体”所属的特殊资质，可授权使用总公司/分公司的特殊资 质； + * 3、最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 + * 示例值：jTpGmxUX3FBWVQ5NJInE4d2I6_H7I4 * */ @SerializedName(value = "qualifications") @@ -248,8 +309,8 @@ public class ApplymentsRequest implements Serializable { * 是否必填：否 * 类型：string(1024) * 描述： - * 最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 - * 示例值：[\"jTpGmg05InE4d2I6_H7I4\"] + * 根据实际审核情况，额外要求提供。最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 + * 示例值：jTpGmg05InE4d2I6_H7I4 * */ @SerializedName(value = "business_addition_pics") @@ -260,9 +321,9 @@ public class ApplymentsRequest implements Serializable { * 字段名：补充说明 * 变量名：business_addition_desc * 是否必填：否 - * 类型：string(256) + * 类型：string(512) * 描述： - * 可填写512字以内 。 + * 1、若主体为“个人卖家”，该字段必传，则需填写描述“ 该商户已持续从事电子商务经营活动满6个月，且期间经营收入累计超过20万元。” * 示例值：特殊情况，说明原因 * */ @@ -274,20 +335,52 @@ public class ApplymentsRequest implements Serializable { public static class BusinessLicenseInfo implements Serializable { /** * 
-     * 字段名：证件扫描件
+     * 字段名：证书类型
+     * 变量名：cert_type
+     * 是否必填：条件选填
+     * 类型：string
+     * 描述：
+     *  1、主体为“政府机关/事业单位/社会组织”时，请上传登记证书类型。
+     *  2、主体为“个体工商户/企业”时，不填。
+     *
+     *  当主体为事业单位时，选择此枚举值：
+     *  CERTIFICATE_TYPE_2388：事业单位法人证书
+     *
+     *  当主体为政府机关，选择此枚举值：
+     *  CERTIFICATE_TYPE_2389：统一社会信用代码证书
+     *
+     *  当主体为社会组织，选择以下枚举值之一：
+     *  CERTIFICATE_TYPE_2389：统一社会信用代码证书
+     *  CERTIFICATE_TYPE_2394：社会团体法人登记证书
+     *  CERTIFICATE_TYPE_2395：民办非企业单位登记证书
+     *  CERTIFICATE_TYPE_2396：基金会法人登记证书
+     *  CERTIFICATE_TYPE_2399：宗教活动场所登记证
+     *  CERTIFICATE_TYPE_2400：政府部门下发的其他有效证明文件
+     *  CERTIFICATE_TYPE_2520：执业许可证/执业证
+     *  CERTIFICATE_TYPE_2521：基层群众性自治组织特别法人统一社会信用代码证
+     *  CERTIFICATE_TYPE_2522：农村集体经济组织登记证
+     *  示例值：CERTIFICATE_TYPE_2388
+     *
+ */ + @SerializedName(value = "cert_type") + private String certType; + + /** + * 
+     * 字段名：营业执照扫描件
      * 变量名：business_license_copy
      * 是否必填：是
      * 类型：string(256)
      * 描述：
      *  1、主体为“个体工商户/企业”时，请上传营业执照的证件图片。
-     *  2、主体为“党政、机关及事业单位/其他组织”时，请上传登记证书的证件图片。
-     *  3、可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID 。
+     *  2、主体为“政府机关/事业单位/社会组织”时，请上传登记证书的证件图片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID 。
      *  4、图片要求：
      *  （1）请上传证件的彩色扫描件或彩色数码拍摄件，黑白复印件需加盖公章（公章信息需完整） 。
      *  （2）不得添加无关水印（非微信支付商户申请用途的其他水印）。
      *  （3）需提供证件的正面拍摄件，完整、照面信息清晰可见。信息不清晰、扭曲、压缩变形、反光、不完整均不接受。
      *  （4）不接受二次剪裁、翻拍、PS的证件照片。
-     *  示例值： 47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     *  示例值：47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
      *
*/ @SerializedName(value = "business_license_copy") @@ -295,15 +388,14 @@ public class ApplymentsRequest implements Serializable { /** * 
-     * 字段名：证件注册号
+     * 字段名：营业执照注册号
      * 变量名：business_license_number
      * 是否必填：是
      * 类型：string(18)
      * 描述：
-     *  1、主体为“个体工商户/企业”时，请填写营业执照上的注册号/统一社会信用代码，须为15位数字或 18位数字|大写字母。
-     *  2、主体为“党政、机关及事业单位/其他组织”时，请填写登记证书的证书编号。
+     *  1、主体为“个体工商户/企业”时，请填写营业执照上的注册号/统一社会信用代码，须为18位数字|大写字母。
+     *  2、主体为“政府机关/事业单位/社会组织”时，请填写登记证书的证书编号。
      *  示例值：123456789012345678
-     *  特殊规则：长度最小15个字节
      *
*/ @SerializedName(value = "business_license_number") @@ -317,7 +409,7 @@ public class ApplymentsRequest implements Serializable { * 类型：string(128) * 描述： * 1、请填写营业执照/登记证书的商家名称，2~110个字符，支持括号 。 - * 2、个体工商户/党政、机关及事业单位，不能以“公司”结尾。 + * 2、个体工商户/政府机关/事业单位/社会组织，不能以“公司”结尾。 * 3、个体工商户，若营业执照上商户名称为空或为“无”，请填写"个体户+经营者姓名"，如“个体户张三” 。 * 示例值：腾讯科技有限公司 * @@ -346,7 +438,7 @@ public class ApplymentsRequest implements Serializable { * 是否必填：条件选填 * 类型：string(128) * 描述： - * 主体为“党政、机关及事业单位/其他组织”时必填，请填写登记证书的注册地址。 + * 主体为“政府机关/事业单位/社会组织”时必填，请填写登记证书的注册地址。 * 示例值：深圳南山区科苑路 * */ @@ -360,11 +452,10 @@ public class ApplymentsRequest implements Serializable { * 是否必填：条件选填 * 类型：string(256) * 描述： - * 1、主体为“党政、机关及事业单位/其他组织”时必填，请填写证件有效期。 + * 1、主体为“政府机关/事业单位/社会组织”时必填，请填写证件有效期。 * 2、若证件有效期为长期，请填写：长期。 * 3、结束时间需大于开始时间。 - * 4、有效期必须大于60天，即结束时间距当前时间需超过60天。 - * 示例值：[\"2014-01-01\",\"长期\"] + * 示例值：["2014-01-01","长期"] * */ @SerializedName(value = "business_time") @@ -374,52 +465,41 @@ public class ApplymentsRequest implements Serializable { @Data @NoArgsConstructor - public static class OrganizationCertInfo implements Serializable { + public static class FinanceInstitutionInfo implements Serializable { /** * 
-     * 字段名：组织机构代码证照片
-     * 变量名：organization_copy
+     * 字段名：金融机构类型
+     * 变量名：finance_type
      * 是否必填：是
-     * 类型：string(256)
+     * 类型：string
      * 描述：
-     *  可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID。
-     *  示例值：vByf3Gjm7KE53JXv\prrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     *  金融机构类型需与营业执照/登记证书上一致，可参考选择金融机构指引。
+     *  BANK_AGENT：银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等
+     *  PAYMENT_AGENT：支付机构, 适用于非银行类支付机构
+     *  INSURANCE：保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务
+     *  TRADE_AND_SETTLE：交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等
+     *  OTHER：其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务
+     *  示例值：BANK_AGENT
      *
*/ - @SerializedName(value = "organization_copy") - private String organizationCopy; + @SerializedName(value = "finance_type") + private String financeType; /** * 
-     * 字段名：组织机构代码
-     * 变量名：organization_number
+     * 字段名：金融机构许可证图片
+     * 变量名：finance_license_pics
      * 是否必填：是
-     * 类型：string(256)
+     * 类型：array
      * 描述：
-     *  1、请填写组织机构代码证上的组织机构代码。
-     *  2、可填写9或10位 数字|字母|连字符。
-     *  示例值：12345679-A
+     *  1、根据所属金融机构类型的许可证要求提供，详情查看金融机构指引。
+     *  2、请提供为“申请商家主体”所属的许可证，可授权使用总公司/分公司的特殊资质。
+     *  3、最多可上传5张照片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  示例值：47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
      *
*/ - @SerializedName(value = "organization_number") - private String organizationNumber; - - /** - * 
-     * 字段名：组织机构代码有效期限
-     * 变量名：organization_time
-     * 是否必填：是
-     * 类型：string(256)
-     * 描述：
-     *  1、请填写组织机构代码证的有效期限，注意参照示例中的格式。
-     *  2、若证件有效期为长期，请填写：长期。
-     *  3、结束时间需大于开始时间。
-     *  4、有效期必须大于60天，即结束时间距当前时间需超过60天。
-     *  示例值：[\"2014-01-01\",\"长期\"]
-     *
- */ - @SerializedName(value = "organization_time") - private String organizationTime; + @SerializedName(value = "finance_license_pics") + private String financeLicensePics; } @@ -433,9 +513,10 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(256) * 描述： - * 1、请上传经营者/法定代表人的身份证人像面照片。 - * 2、可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID。 - * 示例值：xpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ + * 1、证件类型为“身份证”时，上传身份证人像面照片。 + * 2、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。 + * 3、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。 + * 示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ * */ @SerializedName(value = "id_card_copy") @@ -448,9 +529,10 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(256) * 描述： - * 1、请上传经营者/法定代表人的身份证国徽面照片。 - * 2、可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 - * 示例值：vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4 + * 1、证件类型为“身份证”时，上传身份证国徽面照片。 + * 2、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID 。 + * 3、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。 + * 示例值：47ZC6GC-vnrbEny__Ie_An5-tCpqxuZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4 * */ @SerializedName(value = "id_card_national") @@ -464,9 +546,8 @@ public class ApplymentsRequest implements Serializable { * 类型：string(256) * 描述： * 1、请填写经营者/法定代表人对应身份证的姓名，2~30个中文字符、英文字符、符号。 - * 2、该字段需进行加密处理，加密方法详见敏感信息加密说明。 - * 示例值：pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== - * 字段加密:使用APIv3定义的方式加密 + * 2、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) + * 示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== * */ @SerializedName(value = "id_card_name") @@ -478,12 +559,11 @@ public class ApplymentsRequest implements Serializable { * 字段名：身份证号码 * 变量名：id_card_number * 是否必填：是 - * 类型：string(18) + * 类型：string(256) * 描述： * 1、请填写经营者/法定代表人对应身份证的号码。 - * 2、15位数字或17位数字+1位数字|X ，该字段需进行加密处理，加密方法详见敏感信息加密说明。 - * 示例值：zV+BEmytMNQCqQ8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==4 - * 特殊规则：长度最小15个字节 + * 2、15位数字或17位数字+1位数字|X ，该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) + * 示例值：AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CT3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw== * */ @SerializedName(value = "id_card_number") @@ -492,15 +572,46 @@ public class ApplymentsRequest implements Serializable { /** * 
-     * 字段名：身份证有效期限
+     * 字段名：身份证居住地址
+     * 变量名：id_card_address
+     * 是否必填：条件选填
+     * 类型：string(512)
+     * 描述：
+     *  1、主体类型为企业时，需要填写。其他主体类型，无需上传。
+     *  2、请按照身份证住址填写，如广东省深圳市南山区xx路xx号xx室
+     *  3、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4p0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
+     *
+ */ + @SerializedName(value = "id_card_address") + @SpecEncrypt + private String idCardAddress; + + /** + * 
+     * 字段名：身份证开始时间
+     * 变量名：id_card_valid_time_begin
+     * 是否必填：是
+     * 类型：string(128)
+     * 描述：
+     *  1、请按照示例值填写。
+     *  2、结束时间大于开始时间。
+     *  示例值：2019-06-06
+     *
+ */ + @SerializedName(value = "id_card_valid_time_begin") + private String idCardValidTimeBegin; + + /** + * 
+     * 字段名：身份证结束时间
      * 变量名：id_card_valid_time
      * 是否必填：是
      * 类型：string(128)
      * 描述：
-     *  1、请填写身份证有效期的结束时间，注意参照示例中的格式。
-     *  2、若证件有效期为长期，请填写：长期。
-     *  3、证件有效期需大于60天。
-     *  示例值：2026-06-06，长期
+     *  1、请按照示例值填写，若证件有效期为长期，请填写：长期。
+     *  2、结束时间大于开始时间。
+     *  示例值：2026-06-06
      *
*/ @SerializedName(value = "id_card_valid_time") @@ -511,6 +622,39 @@ public class ApplymentsRequest implements Serializable { @Data @NoArgsConstructor public static class IdDocInfo implements Serializable { + /** + * 
+     * 字段名：证件正面照片
+     * 变量名：id_doc_copy
+     * 是否必填：是
+     * 类型：string(256)
+     * 描述：
+     *  1、证件类型不为“身份证”时，上传证件正面照片。
+     *  2、可上传1张图片，请填写通过图片图片上传API预先上传图片生成好的MediaID。
+     *  3、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
+     *
+ */ + @SerializedName(value = "id_doc_copy") + private String idDocCopy; + + /** + * 
+     * 字段名：证件反面照片
+     * 变量名：id_doc_copy_back
+     * 是否必填：条件选填
+     * 类型：string(256)
+     * 描述：
+     *  1、若证件类型为来往通行证、外国人居留证、港澳居住证、台湾居住证时，上传证件反面照片。
+     *  2、若证件类型为护照，无需上传反面照片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID 。
+     *  4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     *
+ */ + @SerializedName(value = "id_doc_copy_back") + private String idDocCopyBack; + /** * 
      * 字段名：证件姓名
@@ -518,8 +662,9 @@ public class ApplymentsRequest implements Serializable {
      * 是否必填：是
      * 类型：string(128)
      * 描述：
-     *  请填写经营者/法人姓名。
-     *  示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4LC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
+     *  1、请填写经营者/法人姓名。
+     *  2、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
      *
*/ @SerializedName(value = "id_doc_name") @@ -531,10 +676,11 @@ public class ApplymentsRequest implements Serializable { * 字段名：证件号码 * 变量名：id_doc_number * 是否必填：是 - * 类型：string(128) + * 类型：string(256) * 描述： * 7~11位 数字|字母|连字符 。 - * 示例值：jTpGmxUX3FBWVQ5NJTZvlKX_go0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ + * 该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) + * 示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ * */ @SerializedName(value = "id_doc_number") @@ -543,29 +689,45 @@ public class ApplymentsRequest implements Serializable { /** * 
-     * 字段名：证件照片
-     * 变量名：id_doc_copy
-     * 是否必填：是
-     * 类型：string(256)
+     * 字段名：证件居住地址
+     * 变量名：id_doc_address
+     * 是否必填：条件选填
+     * 类型：string(512)
      * 描述：
-     *  1、可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID。
-     *  2、2M内的彩色图片，格式可为bmp、png、jpeg、jpg或gif 。
-     *  示例值：xi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     *  1、主体类型为企业时，需要填写。其他主体类型，无需上传。
+     *  2、请按照证件上住址填写，若证件上无住址则按照实际住址填写，如广东省深圳市南山区xx路xx号xx室。
+     *  3、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
      *
*/ - @SerializedName(value = "id_doc_copy") - private String idDocCopy; + @SerializedName(value = "id_doc_address") + @SpecEncrypt + private String idDocAddress; /** * 
-     * 字段名：证件结束日期
+     * 字段名：证件有效期开始时间
+     * 变量名：doc_period_begin
+     * 是否必填：是
+     * 类型：string(128)
+     * 描述：
+     *  1、请按照示例值填写
+     *  2、结束时间大于开始时间
+     *  示例值：2019-06-06
+     *
+ */ + @SerializedName(value = "doc_period_begin") + private String docPeriodBegin; + + /** + * 
+     * 字段名：证件有效期结束时间
      * 变量名：doc_period_end
      * 是否必填：是
      * 类型：string(128)
      * 描述：
-     *  1、请按照示例值填写。
-     *  2、若证件有效期为长期，请填写：长期。
-     *  3、证件有效期需大于60天 。
+     *  1、请按照示例值填写，若证件有效期为长期，请填写：长期。
+     *  2、结束时间大于开始时间。
      *  示例值：2020-01-02
      *
*/ @@ -574,6 +736,144 @@ public class ApplymentsRequest implements Serializable { } + @Data + @NoArgsConstructor + public static class UboInfo implements Serializable { + /** + * 
+     * 字段名：证件类型
+     * 变量名：ubo_id_doc_type
+     * 是否必填：是
+     * 类型：string
+     * 描述：
+     *  请填写受益人的证件类型。
+     *  枚举值：
+     *  IDENTIFICATION_TYPE_MAINLAND_IDCARD：中国大陆居民-身份证
+     *  IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照
+     *  IDENTIFICATION_TYPE_HONGKONG：中国香港居民--来往内地通行证
+     *  IDENTIFICATION_TYPE_MACAO：中国澳门居民--来往内地通行证
+     *  IDENTIFICATION_TYPE_TAIWAN：中国台湾居民--来往大陆通行证
+     *  IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证
+     *  IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证
+     *  IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证
+     *  示例值：IDENTIFICATION_TYPE_MAINLAND_IDCARD
+     *
+ */ + @SerializedName(value = "ubo_id_doc_type") + private String uboIdDocType; + + /** + * 
+     * 字段名：证件正面照片
+     * 变量名：ubo_id_doc_copy
+     * 是否必填：是
+     * 类型：string(256)
+     * 描述：
+     *  1、请上传受益人证件的正面照片。
+     *  2、若证件类型为身份证，请上传人像面照片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ
+     *
+ */ + @SerializedName(value = "ubo_id_doc_copy") + private String uboIdDocCopy; + + /** + * 
+     * 字段名：证件反面照片
+     * 变量名：ubo_id_doc_copy_back
+     * 是否必填：条件选填
+     * 类型：string(256)
+     * 描述：
+     *  1、请上传受益人证件的反面照片。
+     *  2、若证件类型为护照，无需上传反面照片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
+     *
+ */ + @SerializedName(value = "ubo_id_doc_copy_back") + private String uboIdDocCopyBack; + + /** + * 
+     * 字段名：证件姓名
+     * 变量名：ubo_id_doc_name
+     * 是否必填：是
+     * 类型：string(128)
+     * 描述：
+     *  该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
+     *
+ */ + @SerializedName(value = "ubo_id_doc_name") + @SpecEncrypt + private String uboIdDocName; + + /** + * 
+     * 字段名：证件号码
+     * 变量名：ubo_id_doc_number
+     * 是否必填：是
+     * 类型：string(256)
+     * 描述：
+     *  该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
+     *
+ */ + @SerializedName(value = "ubo_id_doc_number") + @SpecEncrypt + private String uboIdDocNumber; + + /** + * 
+     * 字段名：证件居住地址
+     * 变量名：ubo_id_doc_address
+     * 是否必填：条件选填
+     * 类型：string(512)
+     * 描述：
+     *  1、请按照证件上住址填写，若证件上无住址则按照实际住址填写，如广东省深圳市南山区xx路xx号xx室。
+     *  2、 该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfDa4SzfeespQO/0kjiwfqdfg==
+     *
+ */ + @SerializedName(value = "ubo_id_doc_address") + @SpecEncrypt + private String uboIdDocAddress; + + /** + * 
+     * 字段名：证件有效期开始时间
+     * 变量名：ubo_id_doc_period_begin
+     * 是否必填：是
+     * 类型：string(128)
+     * 描述：
+     *  1、请按照示例值填写。
+     *  2、结束时间大于开始时间。
+     *  示例值：2019-06-06
+     *
+ */ + @SerializedName(value = "ubo_id_doc_period_begin") + private String uboIdDocPeriodBegin; + + /** + * 
+     * 字段名：证件有效期结束时间
+     * 变量名：ubo_id_doc_period_end
+     * 是否必填：是
+     * 类型：string(128)
+     * 描述：
+     *  1、请按照示例值填写，若证件有效期为长期，请填写：长期。
+     *  2、结束时间大于开始时间。
+     *  示例值：2026-06-06
+     *
+ */ + @SerializedName(value = "ubo_id_doc_period_end") + private String uboIdDocPeriodEnd; + + } + @Data @NoArgsConstructor public static class AccountInfo implements Serializable { @@ -584,9 +884,9 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(2) * 描述： - * 1、若主体为企业/党政、机关及事业单位/其他组织，可填写：74-对公账户。 - * 2、若主体为小微，可填写：75-对私账户。 - * 3、若主体为个体工商户，可填写：74-对公账户或75-对私账户。 + * 1、若主体为企业/政府机关/事业单位/社会组织，可填写：74-对公账户。 + * 2、主体为小微/个人卖家，可选择：75-对私账户。 + * 3、若主体为个体工商户，可填写：74-对公账户、75-对私账户。 * 示例值：75 * */ @@ -600,7 +900,8 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(10) * 描述： - * 详细参见开户银行对照表。 + * 对私银行调用：查询支持个人业务的银行列表API + * 对公银行调用：查询支持对公业务的银行列表API。 * 示例值：工商银行 * */ @@ -616,8 +917,8 @@ public class ApplymentsRequest implements Serializable { * 描述： * 1、选择经营者个人银行卡时，开户名称必须与身份证姓名一致。 * 2、选择对公账户时，开户名称必须与营业执照上的“商户名称”一致。 - * 3、该字段需进行加密处理，加密方法详见敏感信息加密说明。 - * 示例值：AOZdYGISxo4yw96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw== + * 3、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) + * 示例值：AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw== * */ @SerializedName(value = "account_name") @@ -632,6 +933,8 @@ public class ApplymentsRequest implements Serializable { * 类型：string(12) * 描述： * 至少精确到市，详细参见省市区编号对照表。 + * 注： + * 仅当省市区编号对照表中无对应的省市区编号时，可向上取该银行对应市级编号或省级编号。 * 示例值：110000 * */ @@ -645,8 +948,8 @@ public class ApplymentsRequest implements Serializable { * 是否必填：条件选填 * 类型：string(64) * 描述： - * 1、17家直连银行无需填写，如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 - * 2、详细参见开户银行全称（含支行）对照表。 + * 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 + * 2、详细需调用查询支行列表API查看查询结果。 * 示例值：402713354941 * */ @@ -660,10 +963,9 @@ public class ApplymentsRequest implements Serializable { * 是否必填：条件选填 * 类型：string(128) * 描述： - * 1、17家直连银行无需填写，如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 - * 2、需填写银行全称，如"深圳农村商业银行XXX支行" 。 - * 3、详细参见开户银行全称（含支行）对照表。 - * 示例值：施秉县农村信用合作联社城关信用社 + * 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 + * 2、详细需调用查询支行列表API查看查询结果。 + * 示例值：中国工商银行股份有限公司北京市分行营业部 * */ @SerializedName(value = "bank_name") @@ -677,7 +979,7 @@ public class ApplymentsRequest implements Serializable { * 类型：string(128) * 描述： * 1、数字，长度遵循系统支持的对公/对私卡号长度要求表。 - * 2、该字段需进行加密处理，加密方法详见敏感信息加密说明。 + * 2、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) * 示例值： d+xT+MQCvrLHUVDWv/8MR/dB7TkXLVfSrUxMPZy6jWWYzpRrEEaYQE8ZRGYoeorwC+w== * */ @@ -685,6 +987,70 @@ public class ApplymentsRequest implements Serializable { @SpecEncrypt private String accountNumber; + /** + * 
+     * 字段名：+银行帐户证明材料
+     * 变量名：account_cert_info
+     * 是否必填：否
+     * 类型：string(128)
+     * 描述：
+     *  1. 当主体类型是“政府机关/事业单位”时或所属行业为“党费”时，支持在有合法资金管理关系的情况下结算账户设置为非同名。
+     *  2. 若结算账户设置为非同名，则需填写非同名证明材料，若结算账户为同名，则无需填写。
+     *
+ */ + @SerializedName(value = "account_cert_info") + private AccountCertInfo accountCertInfo; + + @Data + @NoArgsConstructor + public static class AccountCertInfo implements Serializable { + /** + * 
+       * 字段名：结算证明函
+       * 变量名：settlement_cert_pic
+       * 是否必填：是
+       * 类型：string(256)
+       * 描述：
+       *  1. 请参照示例图打印结算证明函。
+       *  2、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+       *  示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+       *
+ */ + @SerializedName(value = "settlement_cert_pic") + private String settlementCertPic; + + /** + * 
+       * 字段名：关系证明函
+       * 变量名：relation_cert_pic
+       * 是否必填：是
+       * 类型：string(256)
+       * 描述：
+       *  1. 请参照示例图打印关系证明函。
+       *  2、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+       *  示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+       *
+ */ + @SerializedName(value = "relation_cert_pic") + private String relationCertPic; + + /** + * 
+       * 字段名：其他补充证明
+       * 变量名：other_cert_pics
+       * 是否必填：是
+       * 类型：array
+       * 描述：
+       *  1. 请提供非同名结算的法律法规、政策通知、政府或上级部门公文等证明文件，以作上述材料的补充证明。
+       *  2、可上传1-3张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+       *  示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+       *
+ */ + @SerializedName(value = "other_cert_pics") + private String otherCertPics; + + } + } @Data @@ -697,8 +1063,8 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(2) * 描述： - * 1、小微商户，选择：65-法人/经营者。 - * 2、个体工商户/企业/党政、机关及事业单位/其他组织，可选择：65-法人/经营者、66- 负责人。 （负责人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。 + * 1、主体为“小微/个人卖家 ”，可选择：65-经营者/法人。 + * 2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：65-经营者/法人、66- 经办人。 （经办人：经商户授权办理微信支付业务的人员）。 * 示例值：65 * */ @@ -713,8 +1079,8 @@ public class ApplymentsRequest implements Serializable { * 类型：string(256) * 描述： * 1、若管理员类型为“法人”，则该姓名需与法人身份证姓名一致。 - * 2、若管理员类型为“经办人”，则可填写实际经办人的姓名。 - * 3、该字段需进行加密处理，加密方法详见敏感信息加密说明。 + * 2、若管理员类型为“经办人”，则可填写实际负责人的姓名。 + * 3、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) * （后续该管理员需使用实名微信号完成签约） * 示例值： pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/wDa4SzfeespQO/0kjiwfqdfg== * @@ -723,24 +1089,128 @@ public class ApplymentsRequest implements Serializable { @SpecEncrypt private String contactName; + /** + * 
+     * 字段名：超级管理员证件类型
+     * 变量名：contact_id_doc_type
+     * 是否必填：条件选填
+     * 类型：string
+     * 描述：
+     *  当超级管理员类型是经办人时，请上传超级管理员证件类型。
+     *  IDENTIFICATION_TYPE_MAINLAND_IDCARD：中国大陆居民-身份证
+     *  IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照
+     *  IDENTIFICATION_TYPE_HONGKONG：中国香港居民--来往内地通行证
+     *  IDENTIFICATION_TYPE_MACAO：中国澳门居民--来往内地通行证
+     *  IDENTIFICATION_TYPE_TAIWAN：中国台湾居民--来往大陆通行证
+     *  IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证
+     *  IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证
+     *  IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证
+     *  示例值：IDENTIFICATION_TYPE_MAINLAND_IDCARD
+     *
+ */ + @SerializedName(value = "contact_id_doc_type") + private String contactIdDocType; + /** * 
      * 字段名：超级管理员身份证件号码
      * 变量名：contact_id_card_number
-     * 是否必填：是
+     * 是否必填：条件选填
      * 类型：string(256)
      * 描述：
-     *  1、若管理员类型为法人，则该身份证号码需与法人身份证号码一致。若管理员类型为经办人，则可填写实际经办人的身份证号码。
+     *  1、若超级管理员类型为法人，则该身份证号码需与法人身份证号码一致。若超级管理员类型为经办人，则可填写实际经办人的身份证号码。
      *  2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。
      *  3、超级管理员签约时，校验微信号绑定的银行卡实名信息，是否与该证件号码一致。
-     *  4、该字段需进行加密处理，加密方法详见敏感信息加密说明。
-     *  示例值：pVd1HJ6zmty7/mYNxLMpRSvMRtelw/wDa4SzfeespQO/0kjiwfqdfg==
+     *  4、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+     *  示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
      *
*/ @SerializedName(value = "contact_id_card_number") @SpecEncrypt private String contactIdCardNumber; + /** + * 
+     * 字段名：超级管理员证件正面照片
+     * 变量名：contact_id_doc_copy
+     * 是否必填：条件选填
+     * 类型：string(256)
+     * 描述：
+     *  1、当超级管理员类型是经办人时，请上传超级管理员证件的正面照片。
+     *  2、若证件类型为身份证，请上传人像面照片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
+     *
+ */ + @SerializedName(value = "contact_id_doc_copy") + private String contactIdDocCopy; + + /** + * 
+     * 字段名：超级管理员证件反面照片
+     * 变量名：contact_id_doc_copy_back
+     * 是否必填：条件选填
+     * 类型：string(256)
+     * 描述：
+     *  1、当超级管理员类型是经办人时，请上传超级管理员证件的反面照片。
+     *  2、若证件类型为护照，无需上传反面照片。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章），可添加“微信支付”相关水印（如微信支付认证）。
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
+     *
+ */ + @SerializedName(value = "contact_id_doc_copy_back") + private String contactIdDocCopyBack; + + /** + * 
+     * 字段名：超级管理员证件有效期开始时间
+     * 变量名：contact_id_doc_period_begin
+     * 是否必填：条件选填
+     * 类型：string(128)
+     * 描述：
+     *  1、当超级管理员类型是经办人时，请上传证件有效期开始时间。
+     *  2、请按照示例值填写。
+     *  3、结束时间大于开始时间。
+     *  示例值：2019-06-06
+     *
+ */ + @SerializedName(value = "contact_id_doc_period_begin") + private String contactIdDocPeriodBegin; + + /** + * 
+     * 字段名：超级管理员证件有效期结束时间
+     * 变量名：contact_id_doc_period_end
+     * 是否必填：条件选填
+     * 类型：string(128)
+     * 描述：
+     *  1、当超级管理员类型是经办人时，请上传证件有效期结束时间。
+     *  2、请按照示例值填写，若证件有效期为长期，请填写：长期。
+     *  3、结束时间大于开始时间。
+     *  示例值：2026-06-06
+     *
+ */ + @SerializedName(value = "contact_id_doc_period_end") + private String contactIdDocPeriodEnd; + + /** + * 
+     * 字段名：业务办理授权函
+     * 变量名：business_authorization_letter
+     * 是否必填：条件选填
+     * 类型：string(256)
+     * 描述：
+     *  1、当超级管理员类型是经办人时，请上传业务办理授权函。
+     *  2、请参照示例图打印业务办理授权函，全部信息需打印，不支持手写商户信息，并加盖公章。
+     *  3、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。
+     *  示例值：47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+     *
+ */ + @SerializedName(value = "business_authorization_letter") + private String businessAuthorizationLetter; + /** * 
      * 字段名：超级管理员手机
@@ -749,7 +1219,7 @@ public class ApplymentsRequest implements Serializable {
      * 类型：string(256)
      * 描述：
      *  1、请填写管理员的手机号，11位数字， 用于接收微信支付的重要管理信息及日常操作验证码 。
-     *  2、该字段需进行加密处理，加密方法详见敏感信息加密说明。
+     *  2、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
      *  示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiNWWNeespQO/0kjiwfqdfg==
      *
*/ @@ -764,9 +1234,10 @@ public class ApplymentsRequest implements Serializable { * 是否必填：是 * 类型：string(256) * 描述： - * 1、用于接收微信支付的开户邮件及日常业务通知。 - * 2、需要带@，遵循邮箱格式校验 。 - * 3、该字段需进行加密处理，加密方法详见敏感信息加密说明。 + * 1、主体类型为“小微商户/个人卖家”可选填，其他主体需必填。 + * 2、用于接收微信支付的开户邮件及日常业务通知。 + * 3、需要带@，遵循邮箱格式校验 。 + * 4、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) * 示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+FWWNUlw/wDa4SzfeespQO/0kjiwfqdfg== * */ @@ -812,9 +1283,13 @@ public class ApplymentsRequest implements Serializable { * 
      * 字段名：店铺二维码
      * 变量名：store_qr_code
-     * 是否必填：1、店铺二维码 or 店铺链接二选一必填。 2、若为电商小程序，可上传店铺页面的小程序二维码。 3、请填写通过图片上传接口预先上传图片生成好的MediaID，仅能上传1张图片 。 示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO1D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
+     * 是否必填：二选一
      * 类型：string(256)
      * 描述：
+     *  1、店铺二维码 or 店铺链接二选一必填。
+     *  2、若为电商小程序，可上传店铺页面的小程序二维码。
+     *  3、请填写通过图片上传API预先上传图片生成好的MediaID，仅能上传1张图片 。
+     *  示例值：jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
      *
*/ @SerializedName(value = "store_qr_code") @@ -827,6 +1302,9 @@ public class ApplymentsRequest implements Serializable { * 是否必填：否 * 类型：string(256) * 描述： + * 1、商户自定义字段，可填写已认证的小程序AppID，认证主体需与二级商户主体一致； + * 2、完成入驻后， 系统发起二级商户号与该AppID的绑定（即配置为sub_appid，可在发起支付时传入） + * 示例值：wxa123344545577 * */ @SerializedName(value = "mini_program_sub_appid") diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/BankService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/BankService.java index e08b9fb52..095510d4f 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/BankService.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/BankService.java @@ -1,7 +1,6 @@ package com.github.binarywang.wxpay.service; -import com.github.binarywang.wxpay.bean.bank.BankAccountResult; -import com.github.binarywang.wxpay.bean.bank.BankingResult; +import com.github.binarywang.wxpay.bean.bank.*; import com.github.binarywang.wxpay.exception.WxPayException; /** @@ -64,4 +63,59 @@ public interface BankService { * @throws WxPayException . */ BankingResult corporateBanking(Integer offset, Integer limit) throws WxPayException; + + /** + * 
+   *
+   * 查询省份列表API
+   * 通过本接口获取省份列表数据（不包含中国港澳台地区），可用于省份下的城市数据查询
+   *
+   * 请求方式：GET（HTTPS）
+   * 请求地址：https://api.mch.weixin.qq.com/v3/capital/capitallhh/areas/provinces
+   *
+   * 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter11_2_4.shtml
+   *
+ * + * @return ProvincesResult 省份列表信息 + * @throws WxPayException . + */ + ProvincesResult areasProvinces() throws WxPayException; + + /** + * 
+   *
+   * 查询城市列表API
+   * 通过本接口根据省份编码获取省份下的城市列表信息，不包含中国港澳台地区城市信息，可用于支行数据过滤查询
+   *
+   * 请求方式：GET（HTTPS）
+   * 请求地址：https://api.mch.weixin.qq.com/v3/capital/capitallhh/areas/provinces/{province_code}/cities
+   *
+   * 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter11_2_5.shtml
+   *
+ * + * @return CitiesResult 城市列表信息 + * @throws WxPayException . + */ + CitiesResult areasCities(Integer provinceCode) throws WxPayException; + + /** + * 
+   *
+   * 查询支行列表API
+   * 本接口可以用于根据银行别名编码（仅支持需要填写支行的银行别名编码）和城市编码过滤查询支行列表数据
+   *
+   * 请求方式：GET（HTTPS）
+   * 请求地址：https://api.mch.weixin.qq.com/v3/capital/capitallhh/banks/{bank_alias_code}/branches
+   *
+   * 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter11_2_5.shtml
+   *
+ * + * @param bankAliasCode 银行别名的编码，查询支行接口仅支持需要填写支行的银行别名编码。示例值：1000006247 + * @param cityCode 城市编码，唯一标识一座城市，用于结合银行别名编码查询支行列表。示例值：536 + * @param offset 非负整数，表示该次请求资源的起始位置，从0开始计数。调用方选填，默认为0。offset为20，limit为100时，查询第21-120条数据 + * @param limit 非0非负的整数，该次请求可返回的最大资源条数。示例值：200 + * @return BankBranchesResult 城市列表信息 + * @throws WxPayException . + */ + BankBranchesResult bankBranches(String bankAliasCode, Integer cityCode, Integer offset, Integer limit) throws WxPayException; } diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/EcommerceService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/EcommerceService.java index b3dbdee01..044ae3936 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/EcommerceService.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/EcommerceService.java @@ -22,7 +22,7 @@ public interface EcommerceService { * 
    * 二级商户进件API
    * 接口地址: https://api.mch.weixin.qq.com/v3/ecommerce/applyments/
-   * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_1.shtml
+   * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_1_8.shtml
    *
    *
* diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BankServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BankServiceImpl.java index 58739b5fd..623a787d9 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BankServiceImpl.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BankServiceImpl.java @@ -1,7 +1,6 @@ package com.github.binarywang.wxpay.service.impl; -import com.github.binarywang.wxpay.bean.bank.BankAccountResult; -import com.github.binarywang.wxpay.bean.bank.BankingResult; +import com.github.binarywang.wxpay.bean.bank.*; import com.github.binarywang.wxpay.exception.WxPayException; import com.github.binarywang.wxpay.service.BankService; import com.github.binarywang.wxpay.service.WxPayService; @@ -43,4 +42,27 @@ public class BankServiceImpl implements BankService { String response = payService.getV3(url); return GSON.fromJson(response, BankingResult.class); } + + @Override + public ProvincesResult areasProvinces() throws WxPayException { + String url = String.format("%s/v3/capital/capitallhh/areas/provinces", this.payService.getPayBaseUrl()); + String response = payService.getV3WithWechatPaySerial(url); + return GSON.fromJson(response, ProvincesResult.class); + } + + @Override + public CitiesResult areasCities(Integer provinceCode) throws WxPayException { + String url = String.format("%s/v3/capital/capitallhh/areas/provinces/%s/cities", this.payService.getPayBaseUrl(), provinceCode); + String response = payService.getV3WithWechatPaySerial(url); + return GSON.fromJson(response, CitiesResult.class); + } + + @Override + public BankBranchesResult bankBranches(String bankAliasCode, Integer cityCode, Integer offset, Integer limit) throws WxPayException { + offset = offset == null ? 0 : offset; + limit = limit == null ? 200 : limit; + String url = String.format("%s/v3/capital/capitallhh/banks/%s/branches?city_code=%s&offset=%s&limit=%s", this.payService.getPayBaseUrl(), bankAliasCode, cityCode, offset, limit); + String response = payService.getV3(url); + return GSON.fromJson(response, BankBranchesResult.class); + } }