| @@ -240,9 +240,10 @@ public interface WxMpPayService { | |||
| * 其中XXXXX为商户需要填写的内容,商户将该链接生成二维码,如需要打印发布二维码,需要采用此格式。商户可调用第三方库生成二维码图片。 | |||
| * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4 | |||
| * </pre> | |||
| * @param productId 产品Id | |||
| * | |||
| * @param productId 产品Id | |||
| * @param sideLength 要生成的二维码的边长,如果为空,则取默认值400 | |||
| * @param logoFile 商户logo图片的文件对象,可以为空 | |||
| * @param logoFile 商户logo图片的文件对象,可以为空 | |||
| * @return 生成的二维码的字节数组 | |||
| */ | |||
| byte[] createScanPayQrcodeMode1(String productId, File logoFile, Integer sideLength); | |||
| @@ -254,8 +255,9 @@ public interface WxMpPayService { | |||
| * 该模式链接较短,生成的二维码打印到结账小票上的识别率较高。 | |||
| * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5 | |||
| * </pre> | |||
| * @param codeUrl 微信返回的交易会话的二维码链接 | |||
| * @param logoFile 商户logo图片的文件对象,可以为空 | |||
| * | |||
| * @param codeUrl 微信返回的交易会话的二维码链接 | |||
| * @param logoFile 商户logo图片的文件对象,可以为空 | |||
| * @param sideLength 要生成的二维码的边长,如果为空,则取默认值400 | |||
| * @return 生成的二维码的字节数组 | |||
| */ | |||
| @@ -273,4 +275,25 @@ public interface WxMpPayService { | |||
| * </pre> | |||
| */ | |||
| void report(WxPayReportRequest request) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 下载对账单 | |||
| * 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。 | |||
| * 注意: | |||
| * 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中,跟原支付单订单号一致,bill_type为REVOKED; | |||
| * 2、微信在次日9点启动生成前一天的对账单,建议商户10点后再获取; | |||
| * 3、对账单中涉及金额的字段单位为“元”。 | |||
| * 4、对账单接口只能下载三个月以内的账单。 | |||
| * 接口链接:https://api.mch.weixin.qq.com/pay/downloadbill | |||
| * 详情请见: <a href="https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_6">下载对账单</a> | |||
| * </pre> | |||
| * | |||
| * @param billDate 对账单日期 bill_date 下载对账单的日期,格式:20140603 | |||
| * @param billType 账单类型 bill_type ALL,返回当日所有订单信息,默认值,SUCCESS,返回当日成功支付的订单,REFUND,返回当日退款订单 | |||
| * @param tarType 压缩账单 tar_type 非必传参数,固定值:GZIP,返回格式为.gzip的压缩包账单。不传则默认为数据流形式。 | |||
| * @param deviceInfo 设备号 device_info 非必传参数,终端设备号 | |||
| * @return 保存到本地的临时文件 | |||
| */ | |||
| File downloadBill(String billDate, String billType, String tarType, String deviceInfo) throws WxErrorException; | |||
| } | |||
| @@ -41,6 +41,7 @@ public class WxMpPayServiceImpl implements WxMpPayService { | |||
| private static final String PAY_BASE_URL = "https://api.mch.weixin.qq.com"; | |||
| private static final String[] TRADE_TYPES = new String[]{"JSAPI", "NATIVE", "APP"}; | |||
| private static final String[] REFUND_ACCOUNT = new String[]{"REFUND_SOURCE_RECHARGE_FUNDS", "REFUND_SOURCE_UNSETTLED_FUNDS"}; | |||
| private static final String[] BILL_TYPE = new String[]{"ALL","REFUND","SUCCESS"};; | |||
| private final Logger log = LoggerFactory.getLogger(this.getClass()); | |||
| private WxMpService wxMpService; | |||
| @@ -121,6 +122,19 @@ public class WxMpPayServiceImpl implements WxMpPayService { | |||
| } | |||
| } | |||
| private void checkParameters(WxPayDownloadBillRequest request) throws WxErrorException { | |||
| BeanUtils.checkRequiredFields(request); | |||
| if (StringUtils.isNotBlank(request.getTarType()) && !"GZIP".equals(request.getTarType())) { | |||
| throw new IllegalArgumentException("tar_type值如果存在,只能为GZIP"); | |||
| } | |||
| if ( !ArrayUtils.contains(BILL_TYPE, request.getBillType())) { | |||
| throw new IllegalArgumentException("bill_tpye目前必须为" + Arrays.toString(BILL_TYPE) + "其中之一,实际值:" + request.getBillType()); | |||
| } | |||
| } | |||
| private void checkParameters(WxPayRefundRequest request) throws WxErrorException { | |||
| BeanUtils.checkRequiredFields(request); | |||
| @@ -373,6 +387,26 @@ public class WxMpPayServiceImpl implements WxMpPayService { | |||
| this.checkResult(result); | |||
| } | |||
| @Override | |||
| public File downloadBill(String billDate, String billType, String tarType, String deviceInfo) throws WxErrorException { | |||
| WxPayDownloadBillRequest request = new WxPayDownloadBillRequest(); | |||
| this.initRequest(request); | |||
| request.setBillType(billType); | |||
| request.setBillDate(billDate); | |||
| request.setTarType(tarType); | |||
| request.setDeviceInfo(deviceInfo); | |||
| this.checkParameters(request); | |||
| request.setSign(this.createSign(request)); | |||
| String url = this.getPayBaseUrl() + "/pay/downloadbill"; | |||
| //TODO 返回的内容可能是文件流,也有可能是xml,需要区分对待 | |||
| String responseContent = this.wxMpService.post(url, request.toXML()); | |||
| WxPayCommonResult result = WxPayBaseResult.fromXML(responseContent, WxPayCommonResult.class); | |||
| this.checkResult(result); | |||
| return null; | |||
| } | |||
| private String executeRequest(String url, String requestStr) throws WxErrorException { | |||
| HttpPost httpPost = new HttpPost(url); | |||
| if (this.wxMpService.getHttpProxy() != null) { | |||
| @@ -0,0 +1,123 @@ | |||
| package me.chanjar.weixin.mp.bean.pay.request; | |||
| import com.thoughtworks.xstream.annotations.XStreamAlias; | |||
| import me.chanjar.weixin.common.annotation.Required; | |||
| /** | |||
| * <pre> | |||
| * 微信支付下载对账单请求参数类 | |||
| * Created by Binary Wang on 2017-01-11. | |||
| * @author <a href="https://github.com/binarywang">binarywang(Binary Wang)</a> | |||
| * </pre> | |||
| */ | |||
| @XStreamAlias("xml") | |||
| public class WxPayDownloadBillRequest extends WxPayBaseRequest { | |||
| /** | |||
| * <pre> | |||
| * 设备号 | |||
| * device_info | |||
| * 否 | |||
| * String(32) | |||
| * 13467007045764 | |||
| * 终端设备号 | |||
| * </pre> | |||
| */ | |||
| @XStreamAlias("device_info") | |||
| private String deviceInfo; | |||
| /** | |||
| * <pre> | |||
| * 签名类型 | |||
| * sign_type | |||
| * 否 | |||
| * String(32) | |||
| * HMAC-SHA256 | |||
| * 签名类型,目前支持HMAC-SHA256和MD5,默认为MD5 | |||
| * </pre> | |||
| */ | |||
| @XStreamAlias("sign_type") | |||
| private String signType; | |||
| /** | |||
| * <pre> | |||
| * 账单类型 | |||
| * bill_type | |||
| * 是 | |||
| * ALL | |||
| * String(8) | |||
| * --ALL,返回当日所有订单信息,默认值 | |||
| * --SUCCESS,返回当日成功支付的订单 | |||
| * --REFUND,返回当日退款订单 | |||
| * </pre> | |||
| */ | |||
| @Required | |||
| @XStreamAlias("bill_type") | |||
| private String billType; | |||
| /** | |||
| * <pre> | |||
| * 对账单日期 | |||
| * bill_date | |||
| * 是 | |||
| * String(8) | |||
| * 20140603 | |||
| * 下载对账单的日期,格式:20140603 | |||
| * </pre> | |||
| */ | |||
| @Required | |||
| @XStreamAlias("bill_date") | |||
| private String billDate; | |||
| /** | |||
| * <pre> | |||
| * 压缩账单 | |||
| * tar_type | |||
| * 否 | |||
| * String(8) | |||
| * GZIP | |||
| * 非必传参数,固定值:GZIP,返回格式为.gzip的压缩包账单。不传则默认为数据流形式。 | |||
| * </pre> | |||
| */ | |||
| @XStreamAlias("tar_type") | |||
| private String tarType; | |||
| public String getDeviceInfo() { | |||
| return deviceInfo; | |||
| } | |||
| public void setDeviceInfo(String deviceInfo) { | |||
| this.deviceInfo = deviceInfo; | |||
| } | |||
| public String getSignType() { | |||
| return signType; | |||
| } | |||
| public void setSignType(String signType) { | |||
| this.signType = signType; | |||
| } | |||
| public String getBillType() { | |||
| return billType; | |||
| } | |||
| public void setBillType(String billType) { | |||
| this.billType = billType; | |||
| } | |||
| public String getBillDate() { | |||
| return billDate; | |||
| } | |||
| public void setBillDate(String billDate) { | |||
| this.billDate = billDate; | |||
| } | |||
| public String getTarType() { | |||
| return tarType; | |||
| } | |||
| public void setTarType(String tarType) { | |||
| this.tarType = tarType; | |||
| } | |||
| } | |||
| @@ -8,9 +8,9 @@ import me.chanjar.weixin.mp.api.WxMpService; | |||
| import me.chanjar.weixin.mp.api.WxXmlMpInMemoryConfigStorage; | |||
| import me.chanjar.weixin.mp.bean.pay.request.*; | |||
| import me.chanjar.weixin.mp.bean.pay.result.*; | |||
| import org.testng.annotations.Guice; | |||
| import org.testng.annotations.Test; | |||
| import org.testng.annotations.*; | |||
| import java.io.File; | |||
| import java.nio.file.Files; | |||
| import java.nio.file.Path; | |||
| @@ -25,6 +25,7 @@ import static org.testng.Assert.*; | |||
| @Test | |||
| @Guice(modules = ApiTestModule.class) | |||
| public class WxMpPayServiceImplTest { | |||
| @Inject | |||
| protected WxMpService wxService; | |||
| @@ -33,6 +34,14 @@ public class WxMpPayServiceImplTest { | |||
| } | |||
| @Test | |||
| public void testDownloadBill() throws Exception { | |||
| File file = this.wxService.getPayService().downloadBill("20170101","ALL","GZIP","1111111"); | |||
| assertNotNull(file); | |||
| //必填字段为空时,抛出异常 | |||
| this.wxService.getPayService().downloadBill("","","",null); | |||
| } | |||
| @Test | |||
| public void testReport() throws Exception { | |||
| WxPayReportRequest request = new WxPayReportRequest(); | |||