🆕 #1723 企业微信增加查询应用消息发送统计的接口

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/EcommerceService.java

@@ -12,7 +12,7 @@ import com.github.binarywang.wxpay.exception.WxPayException;
  * </pre>
  *
  * @author cloudX
- * @date 2020/08/17
+ * @date 2020 /08/17
  */
 public interface EcommerceService {
   /**
@@ -63,8 +63,9 @@ public interface EcommerceService {
    * </pre>
    *
    * @param tradeType 支付方式
-   * @param request 请求对象
-   * @return 微信合单支付返回
+   * @param request   请求对象
+   * @return 微信合单支付返回 transactions result
+   * @throws WxPayException the wx pay exception
    */
   TransactionsResult combine(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException;
 
@@ -75,9 +76,11 @@ public interface EcommerceService {
    * 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/e-combine.shtml
    * </pre>
    *
+   * @param <T>       the type parameter
    * @param tradeType 支付方式
-   * @param request 请求对象
-   * @return 调起支付需要的参数
+   * @param request   请求对象
+   * @return 调起支付需要的参数 t
+   * @throws WxPayException the wx pay exception
    */
   <T> T combineTransactions(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException;
 
@@ -88,32 +91,38 @@ public interface EcommerceService {
    * </pre>
    *
    * @param notifyData 通知数据
-   * @param header 通知头部数据，不传则表示不校验头
-   * @return 解密后通知数据
+   * @param header     通知头部数据，不传则表示不校验头
+   * @return 解密后通知数据 combine transactions notify result
+   * @throws WxPayException the wx pay exception
    */
   CombineTransactionsNotifyResult parseCombineNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;
 
   /**
-   *  <pre>
+   * <pre>
    *  服务商模式普通支付API(APP支付、JSAPI支付、H5支付、NATIVE支付).
    *  请求URL：https://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi
    *  文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/transactions_sl.shtml
    *  </pre>
+   *
    * @param tradeType 支付方式
-   * @param request 请求对象
-   * @return 调起支付需要的参数
+   * @param request   请求对象
+   * @return 调起支付需要的参数 transactions result
+   * @throws WxPayException the wx pay exception
    */
   TransactionsResult partner(TradeTypeEnum tradeType, PartnerTransactionsRequest request) throws WxPayException;
 
   /**
-   *  <pre>
+   * <pre>
    *  服务商模式普通支付API(APP支付、JSAPI支付、H5支付、NATIVE支付).
    *  请求URL：https://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi
    *  文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/transactions_sl.shtml
    *  </pre>
+   *
+   * @param <T>       the type parameter
    * @param tradeType 支付方式
-   * @param request 请求对象
-   * @return 调起支付需要的参数
+   * @param request   请求对象
+   * @return 调起支付需要的参数 t
+   * @throws WxPayException the wx pay exception
    */
   <T> T partnerTransactions(TradeTypeEnum tradeType, PartnerTransactionsRequest request) throws WxPayException;
 
@@ -124,8 +133,9 @@ public interface EcommerceService {
    * </pre>
    *
    * @param notifyData 通知数据
-   * @param header 通知头部数据，不传则表示不校验头
-   * @return 解密后通知数据
+   * @param header     通知头部数据，不传则表示不校验头
+   * @return 解密后通知数据 partner transactions notify result
+   * @throws WxPayException the wx pay exception
    */
   PartnerTransactionsNotifyResult parsePartnerNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;
 
@@ -136,7 +146,8 @@ public interface EcommerceService {
    * </pre>
    *
    * @param accountType 服务商账户类型
-   * @return 返回数据
+   * @return 返回数据 fund balance result
+   * @throws WxPayException the wx pay exception
    */
   FundBalanceResult spNowBalance(SpAccountTypeEnum accountType) throws WxPayException;
 
@@ -147,8 +158,9 @@ public interface EcommerceService {
    * </pre>
    *
    * @param accountType 服务商账户类型
-   * @param date 查询日期 2020-09-11
-   * @return 返回数据
+   * @param date        查询日期 2020-09-11
+   * @return 返回数据 fund balance result
+   * @throws WxPayException the wx pay exception
    */
   FundBalanceResult spDayEndBalance(SpAccountTypeEnum accountType, String date) throws WxPayException;
 
@@ -159,7 +171,8 @@ public interface EcommerceService {
    * </pre>
    *
    * @param subMchid 二级商户号
-   * @return 返回数据
+   * @return 返回数据 fund balance result
+   * @throws WxPayException the wx pay exception
    */
   FundBalanceResult subNowBalance(String subMchid) throws WxPayException;
 
@@ -170,8 +183,9 @@ public interface EcommerceService {
    * </pre>
    *
    * @param subMchid 二级商户号
-   * @param date 查询日期 2020-09-11
-   * @return 返回数据
+   * @param date     查询日期 2020-09-11
+   * @return 返回数据 fund balance result
+   * @throws WxPayException the wx pay exception
    */
   FundBalanceResult subDayEndBalance(String subMchid, String date) throws WxPayException;
 
@@ -182,7 +196,8 @@ public interface EcommerceService {
    * </pre>
    *
    * @param request 分账请求
-   * @return 返回数据
+   * @return 返回数据 profit sharing result
+   * @throws WxPayException the wx pay exception
    */
   ProfitSharingResult profitSharing(ProfitSharingRequest request) throws WxPayException;