diff --git a/weixin4j-base/src/main/java/com/foxinmy/weixin4j/api/CouponApi.java b/weixin4j-base/src/main/java/com/foxinmy/weixin4j/api/CouponApi.java index 6caeae35..38c7a86c 100644 --- a/weixin4j-base/src/main/java/com/foxinmy/weixin4j/api/CouponApi.java +++ b/weixin4j-base/src/main/java/com/foxinmy/weixin4j/api/CouponApi.java @@ -14,103 +14,101 @@ import com.foxinmy.weixin4j.xml.XmlStream; /** * 代金券API - * + * * @className CouponApi * @author jinyu(foxinmy@gmail.com) * @date 2015年3月25日 * @since JDK 1.6 - * @see 代金券 + * @see 代金券 */ public class CouponApi extends MchApi { - public CouponApi(WeixinPayAccount weixinAccount) { - super(weixinAccount); - } + public CouponApi(WeixinPayAccount weixinAccount) { + super(weixinAccount); + } - /** - * 发放代金券(需要证书) - * - * @param couponStockId - * 代金券批次id - * @param partnerTradeNo - * 商户发放凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性 - * @param openId - * 用户的openid - * @param opUserId - * 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 可为空 - * @return 发放结果 - * @see com.foxinmy.weixin4j.payment.coupon.CouponResult - * @see 发放代金券接口 - * @throws WeixinException - */ - public CouponResult sendCoupon(String couponStockId, String partnerTradeNo, - String openId, String opUserId) throws WeixinException { - Map map = createBaseRequestMap(null); - map.put("coupon_stock_id", couponStockId); - map.put("partner_trade_no", partnerTradeNo); - map.put("openid", openId); - // openid记录数（目前支持num=1） - map.put("openid_count", "1"); - // 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 - if (StringUtil.isBlank(opUserId)) { - opUserId = weixinAccount.getMchId(); - } - map.put("op_user_id", opUserId); - map.put("version", "1.0"); - map.put("type", "XML"); - map.put("sign", weixinSignature.sign(map)); - String param = XmlStream.map2xml(map); - WeixinResponse response = getWeixinSSLExecutor().post( - getRequestUri("coupon_send_uri"), param); - return response.getAsObject(new TypeReference() { - }); - } + /** + * 发放代金券(需要证书) + * + * @param couponStockId + * 代金券批次id + * @param partnerTradeNo + * 商户发放凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性 + * @param openId + * 用户的openid + * @param opUserId + * 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 可为空 + * @return 发放结果 + * @see com.foxinmy.weixin4j.payment.coupon.CouponResult + * @see 发放代金券接口 + * @throws WeixinException + */ + public CouponResult sendCoupon(String couponStockId, String partnerTradeNo, String openId, String opUserId) + throws WeixinException { + Map map = createBaseRequestMap(null); + map.put("coupon_stock_id", couponStockId); + map.put("partner_trade_no", partnerTradeNo); + map.put("openid", openId); + // openid记录数（目前支持num=1） + map.put("openid_count", "1"); + // 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 + if (StringUtil.isBlank(opUserId)) { + opUserId = weixinAccount.getMchId(); + } + map.put("op_user_id", opUserId); + map.put("version", "1.0"); + map.put("type", "XML"); + map.put("sign", weixinSignature.sign(map)); + String param = XmlStream.map2xml(map); + WeixinResponse response = getWeixinSSLExecutor().post(getRequestUri("coupon_send_uri"), param); + return response.getAsObject(new TypeReference() { + }); + } - /** - * 查询代金券批次 - * - * @param couponStockId - * 代金券批次ID - * @return 代金券批次信息 - * @see com.foxinmy.weixin4j.payment.coupon.CouponStock - * @see 查询代金券批次信息接口 - * @throws WeixinException - */ - public CouponStock queryCouponStock(String couponStockId) - throws WeixinException { - Map map = createBaseRequestMap(null); - map.put("coupon_stock_id", couponStockId); - map.put("sign", weixinSignature.sign(map)); - String param = XmlStream.map2xml(map); - WeixinResponse response = weixinExecutor.post( - getRequestUri("couponstock_query_uri"), param); - return response.getAsObject(new TypeReference() { - }); - } + /** + * 查询代金券批次 + * + * @param couponStockId + * 代金券批次ID + * @return 代金券批次信息 + * @see com.foxinmy.weixin4j.payment.coupon.CouponStock + * @see 查询代金券批次信息接口 + * @throws WeixinException + */ + public CouponStock queryCouponStock(String couponStockId) throws WeixinException { + Map map = createBaseRequestMap(null); + map.put("coupon_stock_id", couponStockId); + map.put("sign", weixinSignature.sign(map)); + String param = XmlStream.map2xml(map); + WeixinResponse response = weixinExecutor.post(getRequestUri("couponstock_query_uri"), param); + return response.getAsObject(new TypeReference() { + }); + } - /** - * 查询代金券详细 - * - * @param couponId - * 代金券ID - * @return 代金券详细信息 - * @see com.foxinmy.weixin4j.payment.coupon.CouponDetail - * @see 查询代金券详细信息接口 - * @throws WeixinException - */ - public CouponDetail queryCouponDetail(String couponId) - throws WeixinException { - Map map = createBaseRequestMap(null); - map.put("coupon_id", couponId); - map.put("sign", weixinSignature.sign(map)); - String param = XmlStream.map2xml(map); - WeixinResponse response = weixinExecutor.post( - getRequestUri("coupondetail_query_uri"), param); - return response.getAsObject(new TypeReference() { - }); - } + /** + * 查询代金券详细 + * + * @param openId + * 用户ID + * @param couponId + * 代金券ID + * @return 代金券详细信息 + * @see com.foxinmy.weixin4j.payment.coupon.CouponDetail + * @see 查询代金券详细信息接口 + * @throws WeixinException + */ + public CouponDetail queryCouponDetail(String openId, String couponId) throws WeixinException { + Map map = createBaseRequestMap(null); + map.put("openid", openId); + map.put("coupon_id", couponId); + map.put("sign", weixinSignature.sign(map)); + String param = XmlStream.map2xml(map); + WeixinResponse response = weixinExecutor.post(getRequestUri("coupondetail_query_uri"), param); + return response.getAsObject(new TypeReference() { + }); + } } \ No newline at end of file diff --git a/weixin4j-base/src/main/java/com/foxinmy/weixin4j/payment/WeixinPayProxy.java b/weixin4j-base/src/main/java/com/foxinmy/weixin4j/payment/WeixinPayProxy.java index 7530d3c6..23f91174 100644 --- a/weixin4j-base/src/main/java/com/foxinmy/weixin4j/payment/WeixinPayProxy.java +++ b/weixin4j-base/src/main/java/com/foxinmy/weixin4j/payment/WeixinPayProxy.java @@ -57,827 +57,807 @@ import com.foxinmy.weixin4j.util.Weixin4jConfigUtil; */ public class WeixinPayProxy { - /** - * 微信支付API:js支付、扫码支付等接口 - */ - private final PayApi payApi; - /** - * 代金券API - */ - private final CouponApi couponApi; - /** - * 现金API - */ - private final CashApi cashApi; - /** - * 海关API - */ - private final CustomsApi customsApi; - /** - * 商户信息 - */ - private final WeixinPayAccount weixinPayAccount; + /** + * 微信支付API:js支付、扫码支付等接口 + */ + private final PayApi payApi; + /** + * 代金券API + */ + private final CouponApi couponApi; + /** + * 现金API + */ + private final CashApi cashApi; + /** + * 海关API + */ + private final CustomsApi customsApi; + /** + * 商户信息 + */ + private final WeixinPayAccount weixinPayAccount; - /** - * 微信支付接口实现(使用weixin4j.properties配置的account商户信息) - */ - public WeixinPayProxy() { - this(JSON.parseObject(Weixin4jConfigUtil.getValue("account"), - WeixinPayAccount.class)); - } + /** + * 微信支付接口实现(使用weixin4j.properties配置的account商户信息) + */ + public WeixinPayProxy() { + this(JSON.parseObject(Weixin4jConfigUtil.getValue("account"), WeixinPayAccount.class)); + } - /** - * 微信支付接口实现 - * - * @param weixinPayAccount - * 微信商户信息 - */ - public WeixinPayProxy(WeixinPayAccount weixinPayAccount) { - if (weixinPayAccount == null) { - throw new IllegalArgumentException( - "weixinPayAccount must not be empty"); - } - this.weixinPayAccount = weixinPayAccount; - this.payApi = new PayApi(weixinPayAccount); - this.couponApi = new CouponApi(weixinPayAccount); - this.cashApi = new CashApi(weixinPayAccount); - this.customsApi = new CustomsApi(weixinPayAccount); - } + /** + * 微信支付接口实现 + * + * @param weixinPayAccount + * 微信商户信息 + */ + public WeixinPayProxy(WeixinPayAccount weixinPayAccount) { + if (weixinPayAccount == null) { + throw new IllegalArgumentException("weixinPayAccount must not be empty"); + } + this.weixinPayAccount = weixinPayAccount; + this.payApi = new PayApi(weixinPayAccount); + this.couponApi = new CouponApi(weixinPayAccount); + this.cashApi = new CashApi(weixinPayAccount); + this.customsApi = new CustomsApi(weixinPayAccount); + } - /** - * 获取微信商户账号信息 - * - * @return - */ - public WeixinPayAccount getWeixinPayAccount() { - return weixinPayAccount; - } + /** + * 获取微信商户账号信息 + * + * @return + */ + public WeixinPayAccount getWeixinPayAccount() { + return weixinPayAccount; + } - /** - * 获取微信签名类 - * - * @return - */ - public WeixinSignature getWeixinSignature() { - return payApi.getWeixinSignature(); - } + /** + * 获取微信签名类 + * + * @return + */ + public WeixinSignature getWeixinSignature() { + return payApi.getWeixinSignature(); + } - /** - * 统一下单接口
- * 除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易回话标识后再按扫码、JSAPI - * 、APP等不同场景生成交易串调起支付。 - * - * @param payPackage - * 包含订单信息的对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.MchPayPackage - * @see com.foxinmy.weixin4j.payment.mch.PrePay - * @see 统一下单接口 - * - * @return 预支付对象 - */ - public PrePay createPrePay(MchPayPackage payPackage) throws WeixinException { - return payApi.createPrePay(payPackage); - } + /** + * 统一下单接口
+ * 除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易回话标识后再按扫码、JSAPI + * 、APP等不同场景生成交易串调起支付。 + * + * @param payPackage + * 包含订单信息的对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.MchPayPackage + * @see com.foxinmy.weixin4j.payment.mch.PrePay + * @see 统一下单接口 + * + * @return 预支付对象 + */ + public PrePay createPrePay(MchPayPackage payPackage) throws WeixinException { + return payApi.createPrePay(payPackage); + } - /** - * 创建支付请求对象 - * - * @param payPackage - * 支付详情 - * @return 支付请求对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.JSAPIPayRequest JS支付 - * @see com.foxinmy.weixin4j.payment.mch.NATIVEPayRequest 扫码支付 - * @see com.foxinmy.weixin4j.payment.mch.MICROPayRequest 刷卡支付 - * @see com.foxinmy.weixin4j.payment.mch.APPPayRequest APP支付 - * @see com.foxinmy.weixin4j.payment.mch.WAPPayRequest WAP支付 - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @throws WeixinException - */ - public MchPayRequest createPayRequest(MchPayPackage payPackage) - throws WeixinException { - return payApi.createPayRequest(payPackage); - } + /** + * 创建支付请求对象 + * + * @param payPackage + * 支付详情 + * @return 支付请求对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.JSAPIPayRequest JS支付 + * @see com.foxinmy.weixin4j.payment.mch.NATIVEPayRequest 扫码支付 + * @see com.foxinmy.weixin4j.payment.mch.MICROPayRequest 刷卡支付 + * @see com.foxinmy.weixin4j.payment.mch.APPPayRequest APP支付 + * @see com.foxinmy.weixin4j.payment.mch.WAPPayRequest WAP支付 + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @throws WeixinException + */ + public MchPayRequest createPayRequest(MchPayPackage payPackage) throws WeixinException { + return payApi.createPayRequest(payPackage); + } - /** - * 创建JSAPI支付请求对象 - * - * @param openId - * 用户ID - * @param body - * 订单描述 - * @param outTradeNo - * 订单号 - * @param totalFee - * 订单总额(元) - * @param notifyUrl - * 支付通知地址 - * @param createIp - * ip地址 - * @param attach - * 附加数据 非必填 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.JSAPIPayRequest - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @return JSAPI支付对象 - * @throws WeixinException - */ - public MchPayRequest createJSPayRequest(String openId, String body, - String outTradeNo, double totalFee, String notifyUrl, - String createIp, String attach) throws WeixinException { - return payApi.createJSPayRequest(openId, body, outTradeNo, totalFee, - notifyUrl, createIp, attach); - } + /** + * 创建JSAPI支付请求对象 + * + * @param openId + * 用户ID + * @param body + * 订单描述 + * @param outTradeNo + * 订单号 + * @param totalFee + * 订单总额(元) + * @param notifyUrl + * 支付通知地址 + * @param createIp + * ip地址 + * @param attach + * 附加数据 非必填 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.JSAPIPayRequest + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @return JSAPI支付对象 + * @throws WeixinException + */ + public MchPayRequest createJSPayRequest(String openId, String body, String outTradeNo, double totalFee, + String notifyUrl, String createIp, String attach) throws WeixinException { + return payApi.createJSPayRequest(openId, body, outTradeNo, totalFee, notifyUrl, createIp, attach); + } - /** - *

- * 生成编辑地址请求 - *

- * - * err_msg edit_address:ok获取编辑收货地址成功
edit_address:fail获取编辑收货地址失败
- * userName 收货人姓名
telNumber 收货人电话
addressPostalCode 邮编
- * proviceFirstStageName 国标收货地址第一级地址
addressCitySecondStageName - * 国标收货地址第二级地址
addressCountiesThirdStageName 国标收货地址第三级地址
- * addressDetailInfo 详细收货地址信息
nationalCode 收货地址国家码
- * - * @param url - * 当前访问页的URL - * @param oauthToken - * oauth授权时产生的token - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 收货地址共享 - * @return 编辑地址请求JSON串 - */ - public String createAddressRequestJSON(String url, String oauthToken) { - return payApi.createAddressRequestJSON(url, oauthToken); - } + /** + *

+ * 生成编辑地址请求 + *

+ * + * err_msg edit_address:ok获取编辑收货地址成功
+ * edit_address:fail获取编辑收货地址失败
+ * userName 收货人姓名
+ * telNumber 收货人电话
+ * addressPostalCode 邮编
+ * proviceFirstStageName 国标收货地址第一级地址
+ * addressCitySecondStageName 国标收货地址第二级地址
+ * addressCountiesThirdStageName 国标收货地址第三级地址
+ * addressDetailInfo 详细收货地址信息
+ * nationalCode 收货地址国家码
+ * + * @param url + * 当前访问页的URL + * @param oauthToken + * oauth授权时产生的token + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 收货地址共享 + * @return 编辑地址请求JSON串 + */ + public String createAddressRequestJSON(String url, String oauthToken) { + return payApi.createAddressRequestJSON(url, oauthToken); + } - /** - * 创建Native支付(扫码支付)链接【模式一】 - * - * @param productId - * 与订单ID等价 - * @return 支付链接 - * @see com.foxinmy.weixin4j.api.PayApi - * @see 扫码支付 - * - * @see 模式一 - * - */ - public String createNativePayRequest(String productId) { - return payApi.createNativePayRequest(productId); - } + /** + * 创建Native支付(扫码支付)链接【模式一】 + * + * @param productId + * 与订单ID等价 + * @return 支付链接 + * @see com.foxinmy.weixin4j.api.PayApi + * @see 扫码支付 + * + * @see 模式一 + * + */ + public String createNativePayRequest(String productId) { + return payApi.createNativePayRequest(productId); + } - /** - * 创建Native支付(扫码支付)回调对象【模式一】 - * - * @param productId - * 商品ID - * @param body - * 商品描述 - * @param outTradeNo - * 商户内部唯一订单号 - * @param totalFee - * 商品总额 单位元 - * @param notifyUrl - * 支付回调URL - * @param createIp - * 订单生成的机器 IP - * @param attach - * 附加数据 非必填 - * @return Native回调对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.NativePayResponse - * @see 扫码支付 - * - * @see 模式一 - * - * @throws WeixinException - */ - public NativePayResponse createNativePayResponse(String productId, - String body, String outTradeNo, double totalFee, String notifyUrl, - String createIp, String attach) throws WeixinException { - return payApi.createNativePayResponse(productId, body, outTradeNo, - totalFee, notifyUrl, createIp, attach); - } + /** + * 创建Native支付(扫码支付)回调对象【模式一】 + * + * @param productId + * 商品ID + * @param body + * 商品描述 + * @param outTradeNo + * 商户内部唯一订单号 + * @param totalFee + * 商品总额 单位元 + * @param notifyUrl + * 支付回调URL + * @param createIp + * 订单生成的机器 IP + * @param attach + * 附加数据 非必填 + * @return Native回调对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.NativePayResponse + * @see 扫码支付 + * + * @see 模式一 + * + * @throws WeixinException + */ + public NativePayResponse createNativePayResponse(String productId, String body, String outTradeNo, double totalFee, + String notifyUrl, String createIp, String attach) throws WeixinException { + return payApi.createNativePayResponse(productId, body, outTradeNo, totalFee, notifyUrl, createIp, attach); + } - /** - * 创建Native支付(扫码支付)链接【模式二】 - * - * @param productId - * 商品ID - * @param body - * 商品描述 - * @param outTradeNo - * 商户内部唯一订单号 - * @param totalFee - * 商品总额 单位元 - * @param notifyUrl - * 支付回调URL - * @param createIp - * 订单生成的机器 IP - * @param attach - * 附加数据 非必填 - * @return Native支付对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.NATIVEPayRequest - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @see 扫码支付 - * - * @see 模式二 - * - * @throws WeixinException - */ - public MchPayRequest createNativePayRequest(String productId, String body, - String outTradeNo, double totalFee, String notifyUrl, - String createIp, String attach) throws WeixinException { - return payApi.createNativePayRequest(productId, body, outTradeNo, - totalFee, notifyUrl, createIp, attach); - } + /** + * 创建Native支付(扫码支付)链接【模式二】 + * + * @param productId + * 商品ID + * @param body + * 商品描述 + * @param outTradeNo + * 商户内部唯一订单号 + * @param totalFee + * 商品总额 单位元 + * @param notifyUrl + * 支付回调URL + * @param createIp + * 订单生成的机器 IP + * @param attach + * 附加数据 非必填 + * @return Native支付对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.NATIVEPayRequest + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @see 扫码支付 + * + * @see 模式二 + * + * @throws WeixinException + */ + public MchPayRequest createNativePayRequest(String productId, String body, String outTradeNo, double totalFee, + String notifyUrl, String createIp, String attach) throws WeixinException { + return payApi.createNativePayRequest(productId, body, outTradeNo, totalFee, notifyUrl, createIp, attach); + } - /** - * 创建APP支付请求对象 - * - * @param body - * 商品描述 - * @param outTradeNo - * 商户内部唯一订单号 - * @param totalFee - * 商品总额 单位元 - * @param notifyUrl - * 支付回调URL - * @param createIp - * 订单生成的机器 IP - * @param attach - * 附加数据 非必填 - * @return APP支付对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.APPPayRequest - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @see - * APP支付 - * @throws WeixinException - */ - public MchPayRequest createAppPayRequest(String body, String outTradeNo, - double totalFee, String notifyUrl, String createIp, String attach) - throws WeixinException { - return payApi.createAppPayRequest(body, outTradeNo, totalFee, - notifyUrl, createIp, attach); - } + /** + * 创建APP支付请求对象 + * + * @param body + * 商品描述 + * @param outTradeNo + * 商户内部唯一订单号 + * @param totalFee + * 商品总额 单位元 + * @param notifyUrl + * 支付回调URL + * @param createIp + * 订单生成的机器 IP + * @param attach + * 附加数据 非必填 + * @return APP支付对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.APPPayRequest + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @see + * APP支付 + * @throws WeixinException + */ + public MchPayRequest createAppPayRequest(String body, String outTradeNo, double totalFee, String notifyUrl, + String createIp, String attach) throws WeixinException { + return payApi.createAppPayRequest(body, outTradeNo, totalFee, notifyUrl, createIp, attach); + } - /** - * 创建WAP支付请求对象 - * - * @param body - * 商品描述 - * @param outTradeNo - * 商户内部唯一订单号 - * @param totalFee - * 商品总额 单位元 - * @param notifyUrl - * 支付回调URL - * @param createIp - * 订单生成的机器 IP - * @param attach - * 附加数据 非必填 - * @return WAP支付对象 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.WAPPayRequest - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @see WAP支付 - * - * @throws WeixinException - */ - public MchPayRequest createWapPayRequest(String body, String outTradeNo, - double totalFee, String notifyUrl, String createIp, String attach) - throws WeixinException { - return payApi.createWapPayRequest(body, outTradeNo, totalFee, - notifyUrl, createIp, attach); - } + /** + * 创建WAP支付请求对象 + * + * @param body + * 商品描述 + * @param outTradeNo + * 商户内部唯一订单号 + * @param totalFee + * 商品总额 单位元 + * @param notifyUrl + * 支付回调URL + * @param createIp + * 订单生成的机器 IP + * @param attach + * 附加数据 非必填 + * @return WAP支付对象 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.WAPPayRequest + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @see WAP支付 + * + * @throws WeixinException + */ + public MchPayRequest createWapPayRequest(String body, String outTradeNo, double totalFee, String notifyUrl, + String createIp, String attach) throws WeixinException { + return payApi.createWapPayRequest(body, outTradeNo, totalFee, notifyUrl, createIp, attach); + } - /** - * 提交被扫支付 - * - * @param authCode - * 扫码支付授权码 ,设备读取用户微信中的条码或者二维码信息 - * @param body - * 商品描述 - * @param outTradeNo - * 商户内部唯一订单号 - * @param totalFee - * 商品总额 单位元 - * @param createIp - * 订单生成的机器 IP - * @param attach - * 附加数据 非必填 - * @return 支付的订单信息 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.Order - * @see com.foxinmy.weixin4j.payment.mch.MICROPayRequest - * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() - * @see - * 提交被扫支付API - * @throws WeixinException - */ - public MchPayRequest createMicroPayRequest(String authCode, String body, - String outTradeNo, double totalFee, String createIp, String attach) - throws WeixinException { - return payApi.createMicroPayRequest(authCode, body, outTradeNo, - totalFee, createIp, attach); - } + /** + * 提交被扫支付 + * + * @param authCode + * 扫码支付授权码 ,设备读取用户微信中的条码或者二维码信息 + * @param body + * 商品描述 + * @param outTradeNo + * 商户内部唯一订单号 + * @param totalFee + * 商品总额 单位元 + * @param createIp + * 订单生成的机器 IP + * @param attach + * 附加数据 非必填 + * @return 支付的订单信息 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.Order + * @see com.foxinmy.weixin4j.payment.mch.MICROPayRequest + * @see com.foxinmy.weixin4j.payment.mch.MchPayRequest#toRequestString() + * @see + * 提交被扫支付API + * @throws WeixinException + */ + public MchPayRequest createMicroPayRequest(String authCode, String body, String outTradeNo, double totalFee, + String createIp, String attach) throws WeixinException { + return payApi.createMicroPayRequest(authCode, body, outTradeNo, totalFee, createIp, attach); + } - /** - * 订单查询 - *

- * 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
调用支付接口后，返回系统错误或未知交易状态情况；
- * 调用被扫支付API，返回USERPAYING的状态；
调用关单或撤销接口API之前，需确认支付状态； - *

- * - * @param idQuery - * 商户系统内部的订单号, transaction_id、out_trade_no 二 选一,如果同时存在优先级: - * transaction_id> out_trade_no - * @since V3 - * @see com.foxinmy.weixin4j.payment.mch.Order - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 订单查询API - * @return 订单详情 - * @throws WeixinException - */ - public Order queryOrder(IdQuery idQuery) throws WeixinException { - return payApi.queryOrder(idQuery); - } + /** + * 订单查询 + *

+ * 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
+ * 调用支付接口后，返回系统错误或未知交易状态情况；
+ * 调用被扫支付API，返回USERPAYING的状态；
+ * 调用关单或撤销接口API之前，需确认支付状态； + *

+ * + * @param idQuery + * 商户系统内部的订单号, transaction_id、out_trade_no 二 选一,如果同时存在优先级: + * transaction_id> out_trade_no + * @since V3 + * @see com.foxinmy.weixin4j.payment.mch.Order + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 订单查询API + * @return 订单详情 + * @throws WeixinException + */ + public Order queryOrder(IdQuery idQuery) throws WeixinException { + return payApi.queryOrder(idQuery); + } - /** - * 申请退款(请求需要双向证书)
- *

- * 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后， - * 按照退款规则将支付款按原路退到买家帐号上。 - *

- *

- * 1.交易时间超过半年的订单无法提交退款； - * 2.微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交 - * ，要采用原来的退款单号。总退款金额不能超过用户实际支付金额。 - *

- * - * @param idQuery - * 商户系统内部的订单号, transaction_id 、 out_trade_no 二选一,如果同时存在优先级: - * transaction_id> out_trade_no - * @param outRefundNo - * 商户系统内部的退款单号,商 户系统内部唯一,同一退款单号多次请求只退一笔 - * @param totalFee - * 订单总金额,单位为元 - * @param refundFee - * 退款总金额,单位为元,可以做部分退款 - * @param refundFeeType - * 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY - * @param opUserId - * 操作员帐号, 默认为商户号 - * @param refundAccountType - * 退款资金来源,默认使用未结算资金退款：REFUND_SOURCE_UNSETTLED_FUNDS - * @return 退款申请结果 - * @see com.foxinmy.weixin4j.payment.mch.RefundResult - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 申请退款API - * @since V3 - * @throws WeixinException - */ - public RefundResult applyRefund(IdQuery idQuery, String outRefundNo, - double totalFee, double refundFee, CurrencyType refundFeeType, - String opUserId, RefundAccountType refundAccountType) - throws WeixinException { - return payApi.applyRefund(idQuery, outRefundNo, totalFee, refundFee, - refundFeeType, opUserId, refundAccountType); - } + /** + * 申请退款(请求需要双向证书)
+ *

+ * 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后， + * 按照退款规则将支付款按原路退到买家帐号上。 + *

+ *

+ * 1.交易时间超过半年的订单无法提交退款； + * 2.微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交 + * ，要采用原来的退款单号。总退款金额不能超过用户实际支付金额。 + *

+ * + * @param idQuery + * 商户系统内部的订单号, transaction_id 、 out_trade_no 二选一,如果同时存在优先级: + * transaction_id> out_trade_no + * @param outRefundNo + * 商户系统内部的退款单号,商 户系统内部唯一,同一退款单号多次请求只退一笔 + * @param totalFee + * 订单总金额,单位为元 + * @param refundFee + * 退款总金额,单位为元,可以做部分退款 + * @param refundFeeType + * 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY + * @param opUserId + * 操作员帐号, 默认为商户号 + * @param refundAccountType + * 退款资金来源,默认使用未结算资金退款：REFUND_SOURCE_UNSETTLED_FUNDS + * @return 退款申请结果 + * @see com.foxinmy.weixin4j.payment.mch.RefundResult + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 申请退款API + * @since V3 + * @throws WeixinException + */ + public RefundResult applyRefund(IdQuery idQuery, String outRefundNo, double totalFee, double refundFee, + CurrencyType refundFeeType, String opUserId, RefundAccountType refundAccountType) throws WeixinException { + return payApi.applyRefund(idQuery, outRefundNo, totalFee, refundFee, refundFeeType, opUserId, + refundAccountType); + } - /** - * 退款申请(全额退款) - * - * @throws IOException - * - * @see {@link #applyRefund(IdQuery, String, double, double, String,CurrencyType)} - */ - public RefundResult applyRefund(IdQuery idQuery, String outRefundNo, - double totalFee) throws WeixinException { - return payApi.applyRefund(idQuery, outRefundNo, totalFee); - } + /** + * 退款申请(全额退款) + * + * @throws IOException + * + * @see {@link #applyRefund(IdQuery, String, double, double, String,CurrencyType)} + */ + public RefundResult applyRefund(IdQuery idQuery, String outRefundNo, double totalFee) throws WeixinException { + return payApi.applyRefund(idQuery, outRefundNo, totalFee); + } - /** - * 退款查询 - *

- * 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。 - *

- * - * @param idQuery - * 单号 refund_id、out_refund_no、 out_trade_no 、 transaction_id - * 四个参数必填一个,优先级为: - * refund_id>out_refund_no>transaction_id>out_trade_no - * @return 退款记录 - * @see com.foxinmy.weixin4j.api.PayApi - * @see com.foxinmy.weixin4j.payment.mch.RefundRecord - * @see - * 退款查询API - * @since V3 - * @throws WeixinException - */ - public RefundRecord queryRefund(IdQuery idQuery) throws WeixinException { - return payApi.queryRefund(idQuery); - } + /** + * 退款查询 + *

+ * 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。 + *

+ * + * @param idQuery + * 单号 refund_id、out_refund_no、 out_trade_no 、 transaction_id + * 四个参数必填一个,优先级为: + * refund_id>out_refund_no>transaction_id>out_trade_no + * @return 退款记录 + * @see com.foxinmy.weixin4j.api.PayApi + * @see com.foxinmy.weixin4j.payment.mch.RefundRecord + * @see + * 退款查询API + * @since V3 + * @throws WeixinException + */ + public RefundRecord queryRefund(IdQuery idQuery) throws WeixinException { + return payApi.queryRefund(idQuery); + } - /** - * 下载对账单
- * 1.微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账 单中,跟原支付单订单号一致,bill_type 为 - * REVOKED;
- * 2.微信在次日 9 点启动生成前一天的对账单,建议商户 9 点半后再获取;
- * 3.对账单中涉及金额的字段单位为“元”。
- * - * @param billDate - * 下载对账单的日期 - * @param billType - * 下载对账单的类型 ALL,返回当日所有订单信息, 默认值 SUCCESS,返回当日成功支付的订单 - * REFUND,返回当日退款订单 - * @para outputStream 输出流 - * @param tarType - * 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。 - * @since V2 & V3 - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 下载对账单API - * @throws WeixinException - */ - public void downloadBill(Date billDate, BillType billType, - OutputStream outputStream, TarType tarType) throws WeixinException { - payApi.downloadBill(billDate, billType, outputStream, tarType); - } + /** + * 下载对账单
+ * 1.微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账 单中,跟原支付单订单号一致,bill_type 为 + * REVOKED;
+ * 2.微信在次日 9 点启动生成前一天的对账单,建议商户 9 点半后再获取;
+ * 3.对账单中涉及金额的字段单位为“元”。
+ * + * @param billDate + * 下载对账单的日期 + * @param billType + * 下载对账单的类型 ALL,返回当日所有订单信息, 默认值 SUCCESS,返回当日成功支付的订单 + * REFUND,返回当日退款订单 + * @para outputStream 输出流 + * @param tarType + * 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。 + * @since V2 & V3 + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 下载对账单API + * @throws WeixinException + */ + public void downloadBill(Date billDate, BillType billType, OutputStream outputStream, TarType tarType) + throws WeixinException { + payApi.downloadBill(billDate, billType, outputStream, tarType); + } - /** - * 冲正订单(需要证书)
当支付返回失败,或收银系统超时需要取消交易,可以调用该接口
接口逻辑:支 - * 付失败的关单,支付成功的撤销支付
7天以内的单可撤销,其他正常支付的单 - * 如需实现相同功能请调用退款接口
调用扣款接口后请勿立即调用撤销,需要等待5秒以上。先调用查单接口,如果没有确切的返回,再调用撤销
- * - * @param idQuery - * 商户系统内部的订单号, transaction_id 、 out_trade_no 二选一,如果同时存在优先级: - * transaction_id> out_trade_no - * @return 撤销结果 - * @see com.foxinmy.weixin4j.api.PayApi - * @since V3 - * @throws WeixinException - */ - public MerchantResult reverseOrder(IdQuery idQuery) throws WeixinException { - return payApi.reverseOrder(idQuery); - } + /** + * 冲正订单(需要证书)
+ * 当支付返回失败,或收银系统超时需要取消交易,可以调用该接口
+ * 接口逻辑:支 付失败的关单,支付成功的撤销支付
+ * 7天以内的单可撤销,其他正常支付的单 如需实现相同功能请调用退款接口
+ * 调用扣款接口后请勿立即调用撤销,需要等待5秒以上。先调用查单接口,如果没有确切的返回,再调用撤销 + *
+ * + * @param idQuery + * 商户系统内部的订单号, transaction_id 、 out_trade_no 二选一,如果同时存在优先级: + * transaction_id> out_trade_no + * @return 撤销结果 + * @see com.foxinmy.weixin4j.api.PayApi + * @since V3 + * @throws WeixinException + */ + public MerchantResult reverseOrder(IdQuery idQuery) throws WeixinException { + return payApi.reverseOrder(idQuery); + } - /** - * 关闭订单 - *

- * 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续 - * ，请调用关单接口,如果关单失败,返回已完 成支付请按正常支付处理。如果出现银行掉单,调用关单成功后,微信后台会主动发起退款。 - *

- * - * @param outTradeNo - * 商户系统内部的订单号 - * @return 执行结果 - * @see com.foxinmy.weixin4j.api.PayApi - * @since V3 - * @throws WeixinException - * @see - * 关闭订单API - */ - public MerchantResult closeOrder(String outTradeNo) throws WeixinException { - return payApi.closeOrder(outTradeNo); - } + /** + * 关闭订单 + *

+ * 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续 + * ，请调用关单接口,如果关单失败,返回已完 成支付请按正常支付处理。如果出现银行掉单,调用关单成功后,微信后台会主动发起退款。 + *

+ * + * @param outTradeNo + * 商户系统内部的订单号 + * @return 执行结果 + * @see com.foxinmy.weixin4j.api.PayApi + * @since V3 + * @throws WeixinException + * @see + * 关闭订单API + */ + public MerchantResult closeOrder(String outTradeNo) throws WeixinException { + return payApi.closeOrder(outTradeNo); + } - /** - * native支付URL转短链接:用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX)，减小二维码数据量 - * ，提升扫描速度和精确度。 - * - * @param url - * 具有native标识的支付URL - * @return 转换后的短链接 - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 转换短链接API - * @since V3 - * @throws WeixinException - */ - public String getPayShorturl(String url) throws WeixinException { - return payApi.getShorturl(url); - } + /** + * native支付URL转短链接:用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX)，减小二维码数据量 + * ，提升扫描速度和精确度。 + * + * @param url + * 具有native标识的支付URL + * @return 转换后的短链接 + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 转换短链接API + * @since V3 + * @throws WeixinException + */ + public String getPayShorturl(String url) throws WeixinException { + return payApi.getShorturl(url); + } - /** - * 接口上报 - * - * @param interfaceUrl - * 上报对应的接口的完整 URL, 类似: https://api.mch.weixin.q - * q.com/pay/unifiedorder - * @param executeTime - * 接口耗时情况,单位为毫秒 - * @param outTradeNo - * 商户系统内部的订单号,商 户可以在上报时提供相关商户订单号方便微信支付更好 的提高服务质量。 - * @param ip - * 发起接口调用时的机器 IP - * @param time - * 商户调用该接口时商户自己 系统的时间 - * @param returnXml - * 调用接口返回的基本数据 - * @return 处理结果 - * @see com.foxinmy.weixin4j.api.PayApi - * @see - * 接口测试上报API - * @throws WeixinException - */ - public XmlResult reportInterface(String interfaceUrl, int executeTime, - String outTradeNo, String ip, Date time, XmlResult returnXml) - throws WeixinException { - return payApi.reportInterface(interfaceUrl, executeTime, outTradeNo, - ip, time, returnXml); - } + /** + * 接口上报 + * + * @param interfaceUrl + * 上报对应的接口的完整 URL, 类似: https://api.mch.weixin.q + * q.com/pay/unifiedorder + * @param executeTime + * 接口耗时情况,单位为毫秒 + * @param outTradeNo + * 商户系统内部的订单号,商 户可以在上报时提供相关商户订单号方便微信支付更好 的提高服务质量。 + * @param ip + * 发起接口调用时的机器 IP + * @param time + * 商户调用该接口时商户自己 系统的时间 + * @param returnXml + * 调用接口返回的基本数据 + * @return 处理结果 + * @see com.foxinmy.weixin4j.api.PayApi + * @see + * 接口测试上报API + * @throws WeixinException + */ + public XmlResult reportInterface(String interfaceUrl, int executeTime, String outTradeNo, String ip, Date time, + XmlResult returnXml) throws WeixinException { + return payApi.reportInterface(interfaceUrl, executeTime, outTradeNo, ip, time, returnXml); + } - /** - * 发放代金券(需要证书) - * - * @param couponStockId - * 代金券批次id - * @param partnerTradeNo - * 商户发放凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性 - * @param openId - * 用户的openid - * @param opUserId - * 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 可为空 - * @return 发放结果 - * @see com.foxinmy.weixin4j.api.CouponApi - * @see com.foxinmy.weixin4j.payment.coupon.CouponResult - * @see - * 发放代金券接口 - * @throws WeixinException - */ - public CouponResult sendCoupon(String couponStockId, String partnerTradeNo, - String openId, String opUserId) throws WeixinException { - return couponApi.sendCoupon(couponStockId, partnerTradeNo, openId, - opUserId); - } + /** + * 发放代金券(需要证书) + * + * @param couponStockId + * 代金券批次id + * @param partnerTradeNo + * 商户发放凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性 + * @param openId + * 用户的openid + * @param opUserId + * 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 可为空 + * @return 发放结果 + * @see com.foxinmy.weixin4j.api.CouponApi + * @see com.foxinmy.weixin4j.payment.coupon.CouponResult + * @see + * 发放代金券接口 + * @throws WeixinException + */ + public CouponResult sendCoupon(String couponStockId, String partnerTradeNo, String openId, String opUserId) + throws WeixinException { + return couponApi.sendCoupon(couponStockId, partnerTradeNo, openId, opUserId); + } - /** - * 查询代金券批次 - * - * @param couponStockId - * 代金券批次ID - * @return 代金券批次信息 - * @see com.foxinmy.weixin4j.api.CouponApi - * @see com.foxinmy.weixin4j.payment.coupon.CouponStock - * @see - * 查询代金券批次信息接口 - * @throws WeixinException - */ - public CouponStock queryCouponStock(String couponStockId) - throws WeixinException { - return couponApi.queryCouponStock(couponStockId); - } + /** + * 查询代金券批次 + * + * @param couponStockId + * 代金券批次ID + * @return 代金券批次信息 + * @see com.foxinmy.weixin4j.api.CouponApi + * @see com.foxinmy.weixin4j.payment.coupon.CouponStock + * @see + * 查询代金券批次信息接口 + * @throws WeixinException + */ + public CouponStock queryCouponStock(String couponStockId) throws WeixinException { + return couponApi.queryCouponStock(couponStockId); + } - /** - * 查询代金券详细 - * - * @param couponId - * 代金券ID - * @return 代金券详细信息 - * @see com.foxinmy.weixin4j.api.CouponApi - * @see com.foxinmy.weixin4j.payment.coupon.CouponDetail - * @see - * 查询代金券详细信息接口 - * @throws WeixinException - */ - public CouponDetail queryCouponDetail(String couponId) - throws WeixinException { - return couponApi.queryCouponDetail(couponId); - } + /** + * 查询代金券详细 + * + * @param openId + * 用户ID + * @param couponId + * 代金券ID + * @return 代金券详细信息 + * @see com.foxinmy.weixin4j.api.CouponApi + * @see com.foxinmy.weixin4j.payment.coupon.CouponDetail + * @see + * 查询代金券详细信息接口 + * @throws WeixinException + */ + public CouponDetail queryCouponDetail(String openId, String couponId) throws WeixinException { + return couponApi.queryCouponDetail(openId, couponId); + } - /** - * 发放红包 企业向微信用户个人发现金红包 - * - * @param redpacket - * 红包信息 - * @return 发放结果 - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.Redpacket - * @see com.foxinmy.weixin4j.payment.mch.RedpacketSendResult - * @see - * 发放现金红包接口 - * @see - * 发放裂变红包接口 - * @throws WeixinException - */ - public RedpacketSendResult sendRedpack(Redpacket redpacket) - throws WeixinException { - return cashApi.sendRedpack(redpacket); - } + /** + * 发放红包 企业向微信用户个人发现金红包 + * + * @param redpacket + * 红包信息 + * @return 发放结果 + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.Redpacket + * @see com.foxinmy.weixin4j.payment.mch.RedpacketSendResult + * @see + * 发放现金红包接口 + * @see + * 发放裂变红包接口 + * @throws WeixinException + */ + public RedpacketSendResult sendRedpack(Redpacket redpacket) throws WeixinException { + return cashApi.sendRedpack(redpacket); + } - /** - * 批量发放红包 企业向微信用户个人发现金红包 - * - * @param redpacket - * 多个红包信息 - * @return 发放结果 - * @see com.foxinmy.weixin4j.api.CashApi - * @see #sendRedpacks(Redpacket...) - * @throws WeixinException - */ - public List> sendRedpacks( - Redpacket... redpackets) { - return cashApi.sendRedpacks(redpackets); - } + /** + * 批量发放红包 企业向微信用户个人发现金红包 + * + * @param redpacket + * 多个红包信息 + * @return 发放结果 + * @see com.foxinmy.weixin4j.api.CashApi + * @see #sendRedpacks(Redpacket...) + * @throws WeixinException + */ + public List> sendRedpacks(Redpacket... redpackets) { + return cashApi.sendRedpacks(redpackets); + } - /** - * 查询红包记录 - * - * @param outTradeNo - * 商户发放红包的商户订单号 - * @return 红包记录 - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.RedpacketRecord - * @see - * 查询现金红包接口 - * @see - * 查询裂变红包接口 - * @throws WeixinException - */ - public RedpacketRecord queryRedpack(String outTradeNo) - throws WeixinException { - return cashApi.queryRedpack(outTradeNo); - } + /** + * 查询红包记录 + * + * @param outTradeNo + * 商户发放红包的商户订单号 + * @return 红包记录 + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.RedpacketRecord + * @see + * 查询现金红包接口 + * @see + * 查询裂变红包接口 + * @throws WeixinException + */ + public RedpacketRecord queryRedpack(String outTradeNo) throws WeixinException { + return cashApi.queryRedpack(outTradeNo); + } - /** - * 企业付款 实现企业向个人付款，针对部分有开发能力的商户， 提供通过API完成企业付款的功能。 比如目前的保险行业向客户退保、给付、理赔。 - *

- * 接口调用规则： - *

- *

  • 给同一个实名用户付款，单笔单日限额2W/2W - *
  • 给同一个非实名用户付款，单笔单日限额2000/2000 - *
  • 一个商户同一日付款总额限额100W - *
  • 单笔最小金额默认为1元 - *
  • 每个用户每天最多可付款10次，可以在商户平台--API安全进行设置 - *
  • 给同一个用户付款时间间隔不得低于15秒 - * - * @param payment - * 付款信息 - * @return 付款结果 - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.CorpPayment - * @see com.foxinmy.weixin4j.payment.mch.CorpPaymentResult - * @see - * 企业付款接口 - * @throws WeixinException - */ - public CorpPaymentResult sendCorpPayment(CorpPayment payment) - throws WeixinException { - return cashApi.sendCorpPayment(payment); - } + /** + * 企业付款 实现企业向个人付款，针对部分有开发能力的商户， 提供通过API完成企业付款的功能。 比如目前的保险行业向客户退保、给付、理赔。 + *

    + * 接口调用规则： + *

    + *

  • 给同一个实名用户付款，单笔单日限额2W/2W + *
  • 给同一个非实名用户付款，单笔单日限额2000/2000 + *
  • 一个商户同一日付款总额限额100W + *
  • 单笔最小金额默认为1元 + *
  • 每个用户每天最多可付款10次，可以在商户平台--API安全进行设置 + *
  • 给同一个用户付款时间间隔不得低于15秒 + * + * @param payment + * 付款信息 + * @return 付款结果 + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.CorpPayment + * @see com.foxinmy.weixin4j.payment.mch.CorpPaymentResult + * @see + * 企业付款接口 + * @throws WeixinException + */ + public CorpPaymentResult sendCorpPayment(CorpPayment payment) throws WeixinException { + return cashApi.sendCorpPayment(payment); + } - /** - * 企业付款查询 用于商户的企业付款操作进行结果查询，返回付款操作详细结果 - * - * @param outTradeNo - * 商户调用企业付款API时使用的商户订单号 - * @return 付款记录 - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.CorpPaymentRecord - * @see - * 企业付款查询接口 - * @throws WeixinException - */ - public CorpPaymentRecord queryCorpPayment(String outTradeNo) - throws WeixinException { - return cashApi.queryCorpPayment(outTradeNo); - } + /** + * 企业付款查询 用于商户的企业付款操作进行结果查询，返回付款操作详细结果 + * + * @param outTradeNo + * 商户调用企业付款API时使用的商户订单号 + * @return 付款记录 + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.CorpPaymentRecord + * @see + * 企业付款查询接口 + * @throws WeixinException + */ + public CorpPaymentRecord queryCorpPayment(String outTradeNo) throws WeixinException { + return cashApi.queryCorpPayment(outTradeNo); + } - /** - * 授权码查询OPENID - * - * @param authCode - * 扫码支付授权码，设备读取用户微信中的条码或者二维码信息 - * @return 查询结果 - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.OpenIdResult - * @see - * 授权码查询OPENID - * @throws WeixinException - */ - public OpenIdResult authCode2openId(String authCode) throws WeixinException { - return payApi.authCode2openId(authCode); - } + /** + * 授权码查询OPENID + * + * @param authCode + * 扫码支付授权码，设备读取用户微信中的条码或者二维码信息 + * @return 查询结果 + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.OpenIdResult + * @see + * 授权码查询OPENID + * @throws WeixinException + */ + public OpenIdResult authCode2openId(String authCode) throws WeixinException { + return payApi.authCode2openId(authCode); + } - /** - * 查询结算资金 - * - * @param status - * 是否结算 - * @param pageable - * 分页数据 - * @param start - * 开始日期 查询未结算记录时，该字段可不传 - * @param end - * 结束日期 查询未结算记录时，该字段可不传 - * @return 结算金额记录 - * @throws WeixinException - * @see com.foxinmy.weixin4j.api.CashApi - * @see com.foxinmy.weixin4j.payment.mch.SettlementRecord - * @see - * 查询结算资金接口 - */ - public SettlementRecord querySettlement(boolean status, Pageable pageable, - Date start, Date end) throws WeixinException { - return cashApi.querySettlement(status, pageable, start, end); - } + /** + * 查询结算资金 + * + * @param status + * 是否结算 + * @param pageable + * 分页数据 + * @param start + * 开始日期 查询未结算记录时，该字段可不传 + * @param end + * 结束日期 查询未结算记录时，该字段可不传 + * @return 结算金额记录 + * @throws WeixinException + * @see com.foxinmy.weixin4j.api.CashApi + * @see com.foxinmy.weixin4j.payment.mch.SettlementRecord + * @see + * 查询结算资金接口 + */ + public SettlementRecord querySettlement(boolean status, Pageable pageable, Date start, Date end) + throws WeixinException { + return cashApi.querySettlement(status, pageable, start, end); + } - /** - * 查询汇率 - * - * @param currencyType - * 外币币种 - * @param date - * 日期 不填则默认当天 - * @return 汇率对象 - * @throws WeixinException - * @see com.foxinmy.weixin4j.api.CashApi - * @see - * 查询汇率接口 - */ - public double queryExchageRate(CurrencyType currencyType, Date date) - throws WeixinException { - return cashApi.queryExchageRate(currencyType, date); - } + /** + * 查询汇率 + * + * @param currencyType + * 外币币种 + * @param date + * 日期 不填则默认当天 + * @return 汇率对象 + * @throws WeixinException + * @see com.foxinmy.weixin4j.api.CashApi + * @see + * 查询汇率接口 + */ + public double queryExchageRate(CurrencyType currencyType, Date date) throws WeixinException { + return cashApi.queryExchageRate(currencyType, date); + } - /** - * 订单附加信息提交 - * - * @param customsOrder - * 附加订单信息 - * @return 报关结果 - * @see com.foxinmy.weixin4j.api.CustomsApi - * @see com.foxinmy.weixin4j.payment.mch.CustomsOrder - * @see com.foxinmy.weixin4j.payment.mch.CustomsOrderResult - * @see - * 附加订单信息提交接口 - * @throws WeixinException - */ - public CustomsOrderResult declareCustomsOrder(CustomsOrder customsOrder) - throws WeixinException { - return customsApi.declareCustomsOrder(customsOrder); - } + /** + * 订单附加信息提交 + * + * @param customsOrder + * 附加订单信息 + * @return 报关结果 + * @see com.foxinmy.weixin4j.api.CustomsApi + * @see com.foxinmy.weixin4j.payment.mch.CustomsOrder + * @see com.foxinmy.weixin4j.payment.mch.CustomsOrderResult + * @see + * 附加订单信息提交接口 + * @throws WeixinException + */ + public CustomsOrderResult declareCustomsOrder(CustomsOrder customsOrder) throws WeixinException { + return customsApi.declareCustomsOrder(customsOrder); + } - /** - * 订单附加信息查询 - * - * @param idQuery - * out_trade_no,transaction_id,sub_order_no,sub_order_id四选一 - * @param customsCity - * 海关 - * @return 报关记录 - * @see com.foxinmy.weixin4j.payment.mch.CustomsOrderRecord - * @see com.foxinmy.weixin4j.api.CustomsApi - * @see - * 附加订单信息查询接口 - * @throws WeixinException - */ - public CustomsOrderRecord queryCustomsOrder(IdQuery idQuery, - CustomsCity customsCity) throws WeixinException { - return customsApi.queryCustomsOrder(idQuery, customsCity); - } + /** + * 订单附加信息查询 + * + * @param idQuery + * out_trade_no,transaction_id,sub_order_no,sub_order_id四选一 + * @param customsCity + * 海关 + * @return 报关记录 + * @see com.foxinmy.weixin4j.payment.mch.CustomsOrderRecord + * @see com.foxinmy.weixin4j.api.CustomsApi + * @see + * 附加订单信息查询接口 + * @throws WeixinException + */ + public CustomsOrderRecord queryCustomsOrder(IdQuery idQuery, CustomsCity customsCity) throws WeixinException { + return customsApi.queryCustomsOrder(idQuery, customsCity); + } - public final static String VERSION = "1.7.6"; + public final static String VERSION = "1.7.6"; } diff --git a/weixin4j-mp/src/main/java/com/foxinmy/weixin4j/mp/WeixinComponentProxy.java b/weixin4j-mp/src/main/java/com/foxinmy/weixin4j/mp/WeixinComponentProxy.java index d2db44f3..477ad99c 100644 --- a/weixin4j-mp/src/main/java/com/foxinmy/weixin4j/mp/WeixinComponentProxy.java +++ b/weixin4j-mp/src/main/java/com/foxinmy/weixin4j/mp/WeixinComponentProxy.java @@ -52,7 +52,7 @@ public class WeixinComponentProxy { /** * 微信第三方组件接口实现(使用weixin4j.properties配置的account#components账号信息) - * + * * @param cacheStorager * token管理 */ @@ -63,7 +63,7 @@ public class WeixinComponentProxy { /** * 微信第三方组件接口实现 - * + * * @param weixinMpAccount * 账号信息 * @param cacheStorager @@ -124,7 +124,7 @@ public class WeixinComponentProxy { /** * 获取组件的预授权码 需先缓存ticket - * + * * @param componentId * 组件ID * @return 预授权码 @@ -163,7 +163,7 @@ public class WeixinComponentProxy { * 应用组件授权 需先缓存ticket
  • * redirectUri默认填写weixin4j.properties#component.oauth.redirect.uri
  • * state默认填写state - * + * * @param componentId * 组件ID * @see {@link #getComponentAuthorizationURL(String, String,String)} @@ -225,5 +225,5 @@ public class WeixinComponentProxy { authAppId), component(componentId).getTokenManager()); } - public final static String VERSION = "1.7.5"; + public final static String VERSION = "1.7.6"; } diff --git a/weixin4j-qy/src/main/java/com/foxinmy/weixin4j/qy/WeixinSuiteProxy.java b/weixin4j-qy/src/main/java/com/foxinmy/weixin4j/qy/WeixinSuiteProxy.java index 9fa2903b..0f0d00de 100644 --- a/weixin4j-qy/src/main/java/com/foxinmy/weixin4j/qy/WeixinSuiteProxy.java +++ b/weixin4j-qy/src/main/java/com/foxinmy/weixin4j/qy/WeixinSuiteProxy.java @@ -62,7 +62,7 @@ public class WeixinSuiteProxy { /** * 微信第三方套件接口实现(使用weixin4j.properties配置的account账号信息) - * + * * @param cacheStorager * token管理 */ @@ -73,7 +73,7 @@ public class WeixinSuiteProxy { /** * 微信第三方套件接口实现 - * + * * @param weixinQyAccount * 账号信息 * @param cacheStorager @@ -143,7 +143,7 @@ public class WeixinSuiteProxy { /** * 获取套件的预授权码 需先缓存ticket - * + * * @param suiteId * 套件ID * @return 预授权码 @@ -183,7 +183,7 @@ public class WeixinSuiteProxy { * 应用套件授权 需先缓存ticket
  • * redirectUri默认填写weixin4j.properties#suite.oauth.redirect.uri
  • * state默认填写state - * + * * @param suiteId * 套件ID * @see {@link #getSuiteAuthorizationURL(String, String,String)} @@ -285,5 +285,5 @@ public class WeixinSuiteProxy { suite(suiteId).getTokenManager()); } - public final static String VERSION = "1.7.5"; + public final static String VERSION = "1.7.6"; }