promotionDetails;
+
+ @Data
+ @NoArgsConstructor
+ public static class Amount implements Serializable {
+
+ /**
+ *
+ * 字段名：退款金额
+ * 变量名：refund
+ * 是否必填：是
+ * 类型：int
+ * 描述：
+ * 退款金额，币种的最小单位，只能为整数，不能超过原订单支付金额。
+ * 示例值：888
+ *
+ */
+ @SerializedName(value = "refund")
+ private String refund;
+
+ /**
+ *
+ * 字段名：用户退款金额
+ * 变量名：payer_refund
+ * 是否必填：是
+ * 类型：int
+ * 描述：
+ * 退款给用户的金额，不包含所有优惠券金额。
+ * 示例值：888
+ *
+ */
+ @SerializedName(value = "payer_refund")
+ private String payerRefund;
+
+ /**
+ *
+ * 字段名：优惠退款金额
+ * 变量名：discount_refund
+ * 是否必填：否
+ * 类型：int
+ * 描述：
+ * 优惠券的退款金额，原支付单的优惠按比例退款。
+ * 示例值：888
+ *
+ */
+ @SerializedName(value = "discount_refund")
+ private Integer discountRefund;
+
+
+ /**
+ *
+ * 字段名：退款币种
+ * 变量名：currency
+ * 是否必填：否
+ * 类型：string(18)
+ * 描述：
+ * 符合ISO 4217标准的三位字母代码，目前只支持人民币：CNY 。
+ * 示例值： CNY
+ *
+ */
+ @SerializedName(value = "currency")
+ private String currency;
+
+ }
+
+ @Data
+ @NoArgsConstructor
+ public static class PromotionDetail implements Serializable {
+
+ /**
+ *
+ * 字段名：券ID
+ * 变量名：promotion_id
+ * 是否必填：是
+ * 类型：string（32）
+ * 描述：券或者立减优惠id 。
+ * 示例值：109519
+ *
+ */
+ @SerializedName(value = "promotion_id")
+ private String promotionId;
+
+ /**
+ *
+ * 字段名：优惠范围
+ * 变量名：scope
+ * 是否必填：是
+ * 类型：string（32）
+ * 描述： 优惠范围
+ * 枚举值：
+ * GLOBAL：全场代金券
+ * SINGLE：单品优惠
+ * 示例值：GLOBAL
+ *
+ */
+ @SerializedName(value = "scope")
+ private String scope;
+
+ /**
+ *
+ * 字段名：优惠类型
+ * 变量名：type
+ * 是否必填：是
+ * 类型：string（32）
+ * 描述：
+ * 枚举值：
+ * COUPON：充值型代金券，商户需要预先充值营销经费
+ * DISCOUNT：免充值型优惠券，商户不需要预先充值营销经费
+ * 示例值：DISCOUNT
+ *
+ */
+ @SerializedName(value = "type")
+ private String type;
+
+ /**
+ *
+ * 字段名：优惠券面额
+ * 变量名：amount
+ * 是否必填：是
+ * 类型：int
+ * 描述： 用户享受优惠的金额（优惠券面额=微信出资金额+商家出资金额+其他出资方金额 ）。
+ * 示例值：5
+ *
+ */
+ @SerializedName(value = "amount")
+ private Integer amount;
+
+ /**
+ *
+ * 字段名：优惠退款金额
+ * 变量名：refund_amount
+ * 是否必填：是
+ * 类型：int
+ * 描述： 代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金，说明详见《代金券或立减优惠》。
+ * 示例值：100
+ *
+ */
+ @SerializedName(value = "refund_amount")
+ private Integer refundAmount;
+
+ }
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementRequest.java
new file mode 100644
index 000000000..81e4bb5cc
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementRequest.java
@@ -0,0 +1,114 @@
+package com.github.binarywang.wxpay.bean.ecommerce;
+
+import com.github.binarywang.wxpay.v3.SpecEncrypt;
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ *
+ * 普通服务商（支付机构、银行不可用），可使用本接口修改其进件、已签约的特约商户-结算账户信息。
+ * 文档地址:https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_4.shtml
+ *
+ */
+@Data
+@NoArgsConstructor
+public class SettlementRequest implements Serializable {
+
+ /**
+ *
+ * 字段名：账户类型
+ * 变量名：account_type
+ * 是否必填：是
+ * 类型：string(32)
+ * 描述：
+ * 根据特约商户号的主体类型，可选择的账户类型如下：
+ * 1、小微主体：经营者个人银行卡
+ * 2、个体工商户主体：经营者个人银行卡/ 对公银行账户
+ * 3、企业主体：对公银行账户
+ * 4、党政、机关及事业单位主体：对公银行账户
+ * 5、其他组织主体：对公银行账户
+ * 枚举值：
+ * ACCOUNT_TYPE_BUSINESS：对公银行账户
+ * ACCOUNT_TYPE_PRIVATE：经营者个人银行卡
+ * 示例值：ACCOUNT_TYPE_BUSINESS
+ *
+ */
+ @SerializedName(value = "account_type")
+ private String accountType;
+
+ /**
+ *
+ * 字段名：开户银行
+ * 变量名：account_bank
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 请填写开户银行名称，详细参见《开户银行对照表》https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter4_1.shtml。
+ * 示例值：工商银行
+ *
+ */
+ @SerializedName(value = "account_bank")
+ private String accountBank;
+
+ /**
+ *
+ * 字段名：开户银行省市编码
+ * 变量名：bank_address_code
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 需至少精确到市，详细参见《省市区编号对照表》。
+ * 示例值：110000
+ *
+ */
+ @SerializedName(value = "bank_address_code")
+ private String bankAddressCode;
+
+ /**
+ *
+ * 字段名：开户银行全称（含支行）
+ * 变量名：bank_name
+ * 是否必填：否
+ * 类型：string(128)
+ * 描述：
+ * 若开户银行为“其他银行”，则需二选一填写“开户银行全称（含支行）”或“开户银行联行号”。
+ * 填写银行全称，如"深圳农村商业银行XXX支行" ，详细参见开户银行全称（含支行）对照表。
+ * 示例值：施秉县农村信用合作联社城关信用社
+ *
+ */
+ @SerializedName(value = "bank_name")
+ private String bankName;
+
+ /**
+ *
+ * 字段名：开户银行联行号
+ * 变量名：bank_branch_id
+ * 是否必填：否
+ * 类型：string(128)
+ * 描述：
+ * 若开户银行为“其他银行”，则需二选一填写“开户银行全称（含支行）”或“开户银行联行号”。
+ * 填写银行联行号，详细参见《开户银行全称（含支行）对照表》。
+ * 示例值：402713354941
+ *
+ */
+ @SerializedName(value = "bank_branch_id")
+ private String bankBranchId;
+
+ /**
+ *
+ * 字段名：银行账号
+ * 变量名：account_number
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 1、数字，长度遵循系统支持的对公/对私卡号长度要求
+ * 2、该字段需进行加密处理，加密方法详见《敏感信息加密说明》。(提醒：必须在HTTP头中上送Wechatpay-Serial)
+ *
+ */
+ @SpecEncrypt
+ @SerializedName(value = "account_number")
+ private String accountNumber;
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementResult.java
new file mode 100644
index 000000000..50dfbea77
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/ecommerce/SettlementResult.java
@@ -0,0 +1,106 @@
+package com.github.binarywang.wxpay.bean.ecommerce;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 查询结算账户结果
+ *
+ * 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_5.shtml
+ *
+ */
+@Data
+@NoArgsConstructor
+public class SettlementResult implements Serializable {
+ /**
+ *
+ * 字段名：账户类型
+ * 变量名：account_type
+ * 是否必填：是
+ * 类型：string(32)
+ * 描述：
+ * 枚举值：
+ * ACCOUNT_TYPE_BUSINESS：对公银行账户
+ * ACCOUNT_TYPE_PRIVATE：经营者个人银行卡
+ * 示例值：ACCOUNT_TYPE_BUSINESS
+ *
+ */
+ @SerializedName(value = "account_type")
+ private String accountType;
+
+ /**
+ *
+ * 字段名：开户银行
+ * 变量名：account_bank
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 返回特约商户的结算账户-开户银行全称。
+ * 示例值：工商银行
+ *
+ */
+ @SerializedName(value = "account_bank")
+ private String accountBank;
+
+ /**
+ *
+ * 字段名：开户银行全称（含支行）
+ * 变量名：bank_name
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 返回特约商户的结算账户-开户银行全称（含支行）。
+ * 示例值：施秉县农村信用合作联社城关信用社
+ *
+ */
+ @SerializedName(value = "bank_name")
+ private String bankName;
+
+ /**
+ *
+ * 字段名：开户银行联行号
+ * 变量名：bank_branch_id
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 返回特约商户的结算账户-联行号。
+ * 示例值：402713354941
+ *
+ */
+ @SerializedName(value = "bank_branch_id")
+ private String bankBranchId;
+
+ /**
+ *
+ * 字段名：银行账号
+ * 变量名：account_number
+ * 是否必填：是
+ * 类型：string(128)
+ * 描述：
+ * 返回特约商户的结算账户-银行账号，掩码显示。
+ * 示例值：62*************78
+ *
+ */
+ @SerializedName(value = "account_number")
+ private String accountNumber;
+
+ /**
+ *
+ * 字段名：汇款验证结果
+ * 变量名：verify_result
+ * 是否必填：是
+ * 类型：string(32)
+ * 描述：
+ * 返回特约商户的结算账户-汇款验证结果。
+ * VERIFYING：系统汇款验证中，商户可发起提现尝试。
+ * VERIFY_SUCCESS：系统成功汇款，该账户可正常发起提现。
+ * VERIFY_FAIL：系统汇款失败，该账户无法发起提现，请检查修改。
+ * 示例值：VERIFY_SUCCESS
+ *
+ */
+ @SerializedName(value = "verify_result")
+ private String verifyResult;
+}
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 849f17a90..c0bc6444f 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
@@ -273,6 +273,32 @@ public interface EcommerceService {
*/
RefundsResult refunds(RefundsRequest request) throws WxPayException;
+ /**
+ *
+ * 查询退款API
+ * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/refunds/chapter3_2.shtml
+ *
+ *
+ * @param subMchid 二级商户号
+ * @param refundId 微信退款单号
+ * @return 返回数据 return refunds result
+ * @throws WxPayException the wx pay exception
+ */
+ RefundQueryResult queryRefundByRefundId(String subMchid, String refundId) throws WxPayException;
+
+ /**
+ *
+ * 查询退款API
+ * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/refunds/chapter3_2.shtml
+ *
+ *
+ * @param subMchid 二级商户号
+ * @param outRefundNo 商户退款单号
+ * @return 返回数据 return refunds result
+ * @throws WxPayException the wx pay exception
+ */
+ RefundQueryResult queryRefundByOutRefundNo(String subMchid, String outRefundNo) throws WxPayException;
+
/**
*
* 退款通知回调数据处理
@@ -309,4 +335,29 @@ public interface EcommerceService {
* @throws WxPayException the wx pay exception
*/
SpWithdrawResult spWithdraw(SpWithdrawRequest request) throws WxPayException;
+
+ /**
+ *
+ * 修改结算帐号API
+ * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_4.shtml
+ *
+ *
+ * @param subMchid 二级商户号。
+ * @param request 结算帐号
+ * @throws WxPayException the wx pay exception
+ */
+ void modifySettlement(String subMchid, SettlementRequest request) throws WxPayException;
+
+ /**
+ *
+ * 查询结算账户API
+ * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter3_5.shtml
+ *
+ *
+ * @param subMchid 二级商户号。
+ * @return 返回数据 return settlement result
+ * @throws WxPayException the wx pay exception
+ */
+ SettlementResult querySettlement(String subMchid) throws WxPayException;
+
}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/EcommerceServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/EcommerceServiceImpl.java
index 1fd339344..eefc7a264 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/EcommerceServiceImpl.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/EcommerceServiceImpl.java
@@ -210,6 +210,20 @@ public class EcommerceServiceImpl implements EcommerceService {
return GSON.fromJson(response, RefundsResult.class);
}
+ @Override
+ public RefundQueryResult queryRefundByRefundId(String subMchid, String refundId) throws WxPayException {
+ String url = String.format("%s/v3/ecommerce/refunds/id/%s?sub_mchid=%s", this.payService.getPayBaseUrl(), refundId, subMchid);
+ String response = this.payService.getV3(URI.create(url));
+ return GSON.fromJson(response, RefundQueryResult.class);
+ }
+
+ @Override
+ public RefundQueryResult queryRefundByOutRefundNo(String subMchid, String outRefundNo) throws WxPayException {
+ String url = String.format("%s/v3/ecommerce/applyments/out-request-no/%s?sub_mchid=%s", this.payService.getPayBaseUrl(), outRefundNo, subMchid);
+ String response = this.payService.getV3(URI.create(url));
+ return GSON.fromJson(response, RefundQueryResult.class);
+ }
+
@Override
public RefundNotifyResult parseRefundNotifyResult(String notifyData, SignatureHeader header) throws WxPayException {
if(Objects.nonNull(header) && !this.verifyNotifySign(header, notifyData)){
@@ -245,6 +259,20 @@ public class EcommerceServiceImpl implements EcommerceService {
return GSON.fromJson(response, SpWithdrawResult.class);
}
+ @Override
+ public void modifySettlement(String subMchid, SettlementRequest request) throws WxPayException {
+ String url = String.format("%s/v3/apply4sub/sub_merchants/%s/modify-settlement", this.payService.getPayBaseUrl(), subMchid);
+ RsaCryptoUtil.encryptFields(request, this.payService.getConfig().getVerifier().getValidCertificate());
+ this.payService.postV3WithWechatpaySerial(url, GSON.toJson(request));
+ }
+
+ @Override
+ public SettlementResult querySettlement(String subMchid) throws WxPayException {
+ String url = String.format("%s/v3/apply4sub/sub_merchants/%s/settlement", this.payService.getPayBaseUrl(), subMchid);
+ String response = this.payService.getV3(URI.create(url));
+ return GSON.fromJson(response, SettlementResult.class);
+ }
+
/**
* 校验通知签名
* @param header 通知头信息