+ * 业务处理在对应的PayMessageHandler里面处理，在哪里设置PayMessageHandler，详情查看{@link com.egzosn.pay.common.api.PayService#setPayMessageHandler(com.egzosn.pay.common.api.PayMessageHandler)} + *
+ * 如果未设置 {@link com.egzosn.pay.common.api.PayMessageHandler} 那么会使用默认的 {@link com.egzosn.pay.common.api.DefaultPayMessageHandler}
+ * @throws IOException IOException
+ */
+ @RequestMapping(value = "payBack.json")
+ public String payBack(HttpServletRequest request) {
+ //业务处理在对应的PayMessageHandler里面处理，在哪里设置PayMessageHandler，详情查看com.egzosn.pay.common.api.PayService.setPayMessageHandler()
+ return unionPayService.payBack(new HttpRequestNoticeParams(request)).toMessage();
+ }
+
+
+ /**
+ * 查询
+ *
+ * @param order 订单的请求体
+ * @return 返回查询回来的结果集，支付方原值返回
+ */
+ @RequestMapping("query")
+ public Map
- * 查询订单(详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2)
- * 该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。
- * 需要调用查询接口的情况：
- * ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
- * ◆ 调用支付接口后，返回系统错误或未知交易状态情况；
- * ◆ 调用被扫支付API，返回USERPAYING的状态；
- * ◆ 调用关单或撤销接口API之前，需确认支付状态；
- * 接口地址：https://api.mch.weixin.qq.com/pay/orderquery
- *
- *
- * @param transactionId 微信订单号
- * @param outTradeNo 商户系统内部的订单号，当没提供transactionId时需要传这个。
- */
- @Operation(summary = "Query order")
- @GetMapping("/queryOrder")
- public WxPayOrderQueryResult queryOrder(@RequestParam(required = false) String transactionId,
- @RequestParam(required = false) String outTradeNo)
- throws WxPayException {
- return this.wxService.queryOrder(transactionId, outTradeNo);
- }
+ private final WxPayService wxService;
- @Operation(summary = "Query order")
- @PostMapping("/queryOrder")
- public WxPayOrderQueryResult queryOrder(@RequestBody WxPayOrderQueryRequest wxPayOrderQueryRequest) throws WxPayException {
- return this.wxService.queryOrder(wxPayOrderQueryRequest);
- }
+ @Autowired
+ public WxPayController(WxPayService wxService) {
+ this.wxService = wxService;
+ }
- /**
- *
- * 关闭订单
- * 应用场景
- * 以下情况需要调用关单接口：
- * 1. 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
- * 2. 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
- * 注意：订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
- * 接口地址：https://api.mch.weixin.qq.com/pay/closeorder
- * 是否需要证书： 不需要。
- *
- *
- * @param outTradeNo 商户系统内部的订单号
- */
- @Operation(summary = "Close order")
- @GetMapping("/closeOrder/{outTradeNo}")
- public WxPayOrderCloseResult closeOrder(@PathVariable String outTradeNo) throws WxPayException {
- return this.wxService.closeOrder(outTradeNo);
- }
+ /**
+ *
+ * 查询订单(详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2)
+ * 该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。
+ * 需要调用查询接口的情况：
+ * ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
+ * ◆ 调用支付接口后，返回系统错误或未知交易状态情况；
+ * ◆ 调用被扫支付API，返回USERPAYING的状态；
+ * ◆ 调用关单或撤销接口API之前，需确认支付状态；
+ * 接口地址：https://api.mch.weixin.qq.com/pay/orderquery
+ *
+ *
+ * @param transactionId 微信订单号
+ * @param outTradeNo 商户系统内部的订单号，当没提供transactionId时需要传这个。
+ */
+ @Operation(summary = "Query order")
+ @GetMapping("/queryOrder")
+ public WxPayOrderQueryResult queryOrder(@RequestParam(required = false) String transactionId,
+ @RequestParam(required = false) String outTradeNo)
+ throws WxPayException {
+ return this.wxService.queryOrder(transactionId, outTradeNo);
+ }
- @Operation(summary = "Close order")
- @PostMapping("/closeOrder")
- public WxPayOrderCloseResult closeOrder(@RequestBody WxPayOrderCloseRequest wxPayOrderCloseRequest) throws WxPayException {
- return this.wxService.closeOrder(wxPayOrderCloseRequest);
- }
+ @Operation(summary = "Query order")
+ @PostMapping("/queryOrder")
+ public WxPayOrderQueryResult queryOrder(@RequestBody WxPayOrderQueryRequest wxPayOrderQueryRequest)
+ throws WxPayException {
+ return this.wxService.queryOrder(wxPayOrderQueryRequest);
+ }
- /**
- * 调用统一下单接口，并组装生成支付所需参数对象.
- *
- * @param request 统一下单请求参数
- * @param
+ * 关闭订单
+ * 应用场景
+ * 以下情况需要调用关单接口：
+ * 1. 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
+ * 2. 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
+ * 注意：订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
+ * 接口地址：https://api.mch.weixin.qq.com/pay/closeorder
+ * 是否需要证书： 不需要。
+ *
+ *
+ * @param outTradeNo 商户系统内部的订单号
+ */
+ @Operation(summary = "Close order")
+ @GetMapping("/closeOrder/{outTradeNo}")
+ public WxPayOrderCloseResult closeOrder(@PathVariable String outTradeNo) throws WxPayException {
+ return this.wxService.closeOrder(outTradeNo);
+ }
- /**
- * 统一下单(详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1)
- * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
- * 接口地址：https://api.mch.weixin.qq.com/pay/unifiedorder
- *
- * @param request 请求对象，注意一些参数如appid、mchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）
- */
- @Operation(summary = "原生的统一下单接口")
- @PostMapping("/unifiedOrder")
- public WxPayUnifiedOrderResult unifiedOrder(@RequestBody WxPayUnifiedOrderRequest request) throws WxPayException {
- return this.wxService.unifiedOrder(request);
- }
+ @Operation(summary = "Close order")
+ @PostMapping("/closeOrder")
+ public WxPayOrderCloseResult closeOrder(@RequestBody WxPayOrderCloseRequest wxPayOrderCloseRequest)
+ throws WxPayException {
+ return this.wxService.closeOrder(wxPayOrderCloseRequest);
+ }
- /**
- *
- * 微信支付-申请退款
- * 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4
- * 接口链接：https://api.mch.weixin.qq.com/secapi/pay/refund
- *
- *
- * @param request 请求对象
- * @return 退款操作结果
- */
- @Operation(summary = "Refund")
- @PostMapping("/refund")
- public WxPayRefundResult refund(@RequestBody WxPayRefundRequest request) throws WxPayException {
- return this.wxService.refund(request);
- }
+ /**
+ * 调用统一下单接口，并组装生成支付所需参数对象.
+ *
+ * @param request 统一下单请求参数
+ * @param
- * 微信支付-查询退款
- * 应用场景：
- * 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，
- * 银行卡支付的退款3个工作日后重新查询退款状态。
- * 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5
- * 接口链接：https://api.mch.weixin.qq.com/pay/refundquery
- *
- * 以下四个参数四选一
- *
- * @param transactionId 微信订单号
- * @param outTradeNo 商户订单号
- * @param outRefundNo 商户退款单号
- * @param refundId 微信退款单号
- * @return 退款信息
- */
- @Operation(summary = "退款查询")
- @GetMapping("/refundQuery")
- public WxPayRefundQueryResult refundQuery(@RequestParam(required = false) String transactionId,
- @RequestParam(required = false) String outTradeNo,
- @RequestParam(required = false) String outRefundNo,
- @RequestParam(required = false) String refundId)
- throws WxPayException {
- return this.wxService.refundQuery(transactionId, outTradeNo, outRefundNo, refundId);
- }
+ /**
+ * 统一下单(详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1)
+ * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
+ * 接口地址：https://api.mch.weixin.qq.com/pay/unifiedorder
+ *
+ * @param request 请求对象，注意一些参数如appid、mchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）
+ */
+ @Operation(summary = "原生的统一下单接口")
+ @PostMapping("/unifiedOrder")
+ public WxPayUnifiedOrderResult unifiedOrder(@RequestBody WxPayUnifiedOrderRequest request) throws WxPayException {
+ return this.wxService.unifiedOrder(request);
+ }
- @Operation(summary = "退款查询")
- @PostMapping("/refundQuery")
- public WxPayRefundQueryResult refundQuery(@RequestBody WxPayRefundQueryRequest wxPayRefundQueryRequest) throws WxPayException {
- return this.wxService.refundQuery(wxPayRefundQueryRequest);
- }
+ /**
+ *
+ * 微信支付-申请退款
+ * 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4
+ * 接口链接：https://api.mch.weixin.qq.com/secapi/pay/refund
+ *
+ *
+ * @param request 请求对象
+ * @return 退款操作结果
+ */
+ @Operation(summary = "Refund")
+ @PostMapping("/refund")
+ public WxPayRefundResult refund(@RequestBody WxPayRefundRequest request) throws WxPayException {
+ return this.wxService.refund(request);
+ }
- @Operation(summary = "支付回调通知处理")
- @PostMapping("/notify/order")
- public String parseOrderNotifyResult(@RequestBody String xmlData) throws WxPayException {
- final WxPayOrderNotifyResult notifyResult = this.wxService.parseOrderNotifyResult(xmlData);
- // TODO 根据自己业务场景需要构造返回对象
- return WxPayNotifyResponse.success("成功");
- }
+ /**
+ *
+ * 微信支付-查询退款
+ * 应用场景：
+ * 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，
+ * 银行卡支付的退款3个工作日后重新查询退款状态。
+ * 详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5
+ * 接口链接：https://api.mch.weixin.qq.com/pay/refundquery
+ *
+ *
+ * 以下四个参数四选一
+ *
+ * @param transactionId 微信订单号
+ * @param outTradeNo 商户订单号
+ * @param outRefundNo 商户退款单号
+ * @param refundId 微信退款单号
+ * @return 退款信息
+ */
+ @Operation(summary = "退款查询")
+ @GetMapping("/refundQuery")
+ public WxPayRefundQueryResult refundQuery(@RequestParam(required = false) String transactionId,
+ @RequestParam(required = false) String outTradeNo,
+ @RequestParam(required = false) String outRefundNo,
+ @RequestParam(required = false) String refundId)
+ throws WxPayException {
+ return this.wxService.refundQuery(transactionId, outTradeNo, outRefundNo, refundId);
+ }
- @Operation(summary = "退款回调通知处理")
- @PostMapping("/notify/refund")
- public String parseRefundNotifyResult(@RequestBody String xmlData) throws WxPayException {
- final WxPayRefundNotifyResult result = this.wxService.parseRefundNotifyResult(xmlData);
- // TODO 根据自己业务场景需要构造返回对象
- return WxPayNotifyResponse.success("成功");
- }
+ @Operation(summary = "退款查询")
+ @PostMapping("/refundQuery")
+ public WxPayRefundQueryResult refundQuery(@RequestBody WxPayRefundQueryRequest wxPayRefundQueryRequest)
+ throws WxPayException {
+ return this.wxService.refundQuery(wxPayRefundQueryRequest);
+ }
- @Operation(summary = "扫码支付回调通知处理")
- @PostMapping("/notify/scanpay")
- public String parseScanPayNotifyResult(String xmlData) throws WxPayException {
- final WxScanPayNotifyResult result = this.wxService.parseScanPayNotifyResult(xmlData);
- // TODO 根据自己业务场景需要构造返回对象
- return WxPayNotifyResponse.success("成功");
- }
+ @Operation(summary = "支付回调通知处理")
+ @PostMapping("/notify/order")
+ public String parseOrderNotifyResult(@RequestBody String xmlData) throws WxPayException {
+ final WxPayOrderNotifyResult notifyResult = this.wxService.parseOrderNotifyResult(xmlData);
+ // TODO 根据自己业务场景需要构造返回对象
+ return WxPayNotifyResponse.success("成功");
+ }
- /**
- * 发送微信红包给个人用户
- *
- * 文档详见:
- * 发送普通红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3
- * 接口地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack
- * 发送裂变红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_5&index=4
- * 接口地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack
- *
- *
- * @param request 请求对象
- */
- @Operation(summary = "发送红包")
- @PostMapping("/sendRedpack")
- public WxPaySendRedpackResult sendRedpack(@RequestBody WxPaySendRedpackRequest request) throws WxPayException {
- return this.wxService.getRedpackService().sendRedpack(request);
- }
+ @Operation(summary = "退款回调通知处理")
+ @PostMapping("/notify/refund")
+ public String parseRefundNotifyResult(@RequestBody String xmlData) throws WxPayException {
+ final WxPayRefundNotifyResult result = this.wxService.parseRefundNotifyResult(xmlData);
+ // TODO 根据自己业务场景需要构造返回对象
+ return WxPayNotifyResponse.success("成功");
+ }
- /**
- *
- * 查询红包记录
- * 用于商户对已发放的红包进行查询红包的具体信息，可支持普通红包和裂变包。
- * 请求Url https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo
- * 是否需要证书 是（证书及使用说明详见商户证书）
- * 请求方式 POST
- *
- *
- * @param mchBillNo 商户发放红包的商户订单号，比如10000098201411111234567890
- */
- @Operation(summary = "查询红包")
- @GetMapping("/queryRedpack/{mchBillNo}")
- public WxPayRedpackQueryResult queryRedpack(@PathVariable String mchBillNo) throws WxPayException {
- return this.wxService.getRedpackService().queryRedpack(mchBillNo);
- }
+ @Operation(summary = "扫码支付回调通知处理")
+ @PostMapping("/notify/scanpay")
+ public String parseScanPayNotifyResult(String xmlData) throws WxPayException {
+ final WxScanPayNotifyResult result = this.wxService.parseScanPayNotifyResult(xmlData);
+ // TODO 根据自己业务场景需要构造返回对象
+ return WxPayNotifyResponse.success("成功");
+ }
- /**
- *
- * 扫码支付模式一生成二维码的方法
- * 二维码中的内容为链接，形式为：
- * weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX
- * 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。
- * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
- *
- *
- * @param productId 产品Id
- * @param logoFile 商户logo图片的文件对象，可以为空
- * @param sideLength 要生成的二维码的边长，如果为空，则取默认值400
- * @return 生成的二维码的字节数组
- */
- public byte[] createScanPayQrcodeMode1(String productId, File logoFile, Integer sideLength) throws Exception {
- return this.wxService.createScanPayQrcodeMode1(productId, logoFile, sideLength);
- }
+ /**
+ * 发送微信红包给个人用户
+ *
+ *
+ * 文档详见:
+ * 发送普通红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3
+ * 接口地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack
+ * 发送裂变红包 https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_5&index=4
+ * 接口地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack
+ *
+ *
+ * @param request 请求对象
+ */
+ @Operation(summary = "发送红包")
+ @PostMapping("/sendRedpack")
+ public WxPaySendRedpackResult sendRedpack(@RequestBody WxPaySendRedpackRequest request) throws WxPayException {
+ return this.wxService.getRedpackService().sendRedpack(request);
+ }
- /**
- *
- * 扫码支付模式一生成二维码的方法
- * 二维码中的内容为链接，形式为：
- * weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX
- * 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。
- * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
- *
- *
- * @param productId 产品Id
- * @return 生成的二维码URL连接
- */
- public String createScanPayQrcodeMode1(String productId) {
- return this.wxService.createScanPayQrcodeMode1(productId);
- }
+ /**
+ *
+ * 查询红包记录
+ * 用于商户对已发放的红包进行查询红包的具体信息，可支持普通红包和裂变包。
+ * 请求Url https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo
+ * 是否需要证书 是（证书及使用说明详见商户证书）
+ * 请求方式 POST
+ *
+ *
+ * @param mchBillNo 商户发放红包的商户订单号，比如10000098201411111234567890
+ */
+ @Operation(summary = "查询红包")
+ @GetMapping("/queryRedpack/{mchBillNo}")
+ public WxPayRedpackQueryResult queryRedpack(@PathVariable String mchBillNo) throws WxPayException {
+ return this.wxService.getRedpackService().queryRedpack(mchBillNo);
+ }
- /**
- *
- * 扫码支付模式二生成二维码的方法
- * 对应链接格式：weixin：//wxpay/bizpayurl?sr=XXXXX。请商户调用第三方库将code_url生成二维码图片。
- * 该模式链接较短，生成的二维码打印到结账小票上的识别率较高。
- * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5
- *
- *
- * @param codeUrl 微信返回的交易会话的二维码链接
- * @param logoFile 商户logo图片的文件对象，可以为空
- * @param sideLength 要生成的二维码的边长，如果为空，则取默认值400
- * @return 生成的二维码的字节数组
- */
- public byte[] createScanPayQrcodeMode2(String codeUrl, File logoFile, Integer sideLength) throws Exception {
- return this.wxService.createScanPayQrcodeMode2(codeUrl, logoFile, sideLength);
- }
+ /**
+ *
+ * 扫码支付模式一生成二维码的方法
+ * 二维码中的内容为链接，形式为：
+ * weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX
+ * 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。
+ * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
+ *
+ *
+ * @param productId 产品Id
+ * @param logoFile 商户logo图片的文件对象，可以为空
+ * @param sideLength 要生成的二维码的边长，如果为空，则取默认值400
+ * @return 生成的二维码的字节数组
+ */
+ public byte[] createScanPayQrcodeMode1(String productId, File logoFile, Integer sideLength) throws Exception {
+ return this.wxService.createScanPayQrcodeMode1(productId, logoFile, sideLength);
+ }
- /**
- *
- * 交易保障
- * 应用场景：
- * 商户在调用微信支付提供的相关接口时，会得到微信支付返回的相关信息以及获得整个接口的响应时间。
- * 为提高整体的服务水平，协助商户一起提高服务质量，微信支付提供了相关接口调用耗时和返回信息的主动上报接口，
- * 微信支付可以根据商户侧上报的数据进一步优化网络部署，完善服务监控，和商户更好的协作为用户提供更好的业务体验。
- * 接口地址： https://api.mch.weixin.qq.com/payitil/report
- * 是否需要证书：不需要
- *
- */
- @Operation(summary = "提交交易保障数据")
- @PostMapping("/report")
- public void report(@RequestBody WxPayReportRequest request) throws WxPayException {
- this.wxService.report(request);
- }
+ /**
+ *
+ * 扫码支付模式一生成二维码的方法
+ * 二维码中的内容为链接，形式为：
+ * weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX
+ * 其中XXXXX为商户需要填写的内容，商户将该链接生成二维码，如需要打印发布二维码，需要采用此格式。商户可调用第三方库生成二维码图片。
+ * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
+ *
+ *
+ * @param productId 产品Id
+ * @return 生成的二维码URL连接
+ */
+ public String createScanPayQrcodeMode1(String productId) {
+ return this.wxService.createScanPayQrcodeMode1(productId);
+ }
- /**
- *
- * 下载对账单
- * 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。
- * 注意：
- * 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED；
- * 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取；
- * 3、对账单中涉及金额的字段单位为“元”。
- * 4、对账单接口只能下载三个月以内的账单。
- * 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill
- * 详情请见: 下载对账单
- *
- *
- * @param billDate 对账单日期 bill_date 下载对账单的日期，格式：20140603
- * @param billType 账单类型 bill_type ALL，返回当日所有订单信息，默认值，SUCCESS，返回当日成功支付的订单，REFUND，返回当日退款订单
- * @param tarType 压缩账单 tar_type 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。
- * @param deviceInfo 设备号 device_info 非必传参数，终端设备号
- * @return 保存到本地的临时文件
- */
- @Operation(summary = "下载对账单")
- @GetMapping("/downloadBill/{billDate}/{billType}/{tarType}/{deviceInfo}")
- public WxPayBillResult downloadBill(@PathVariable String billDate, @PathVariable String billType,
- @PathVariable String tarType, @PathVariable String deviceInfo) throws WxPayException {
- return this.wxService.downloadBill(billDate, billType, tarType, deviceInfo);
- }
+ /**
+ *
+ * 扫码支付模式二生成二维码的方法
+ * 对应链接格式：weixin：//wxpay/bizpayurl?sr=XXXXX。请商户调用第三方库将code_url生成二维码图片。
+ * 该模式链接较短，生成的二维码打印到结账小票上的识别率较高。
+ * 文档详见: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5
+ *
+ *
+ * @param codeUrl 微信返回的交易会话的二维码链接
+ * @param logoFile 商户logo图片的文件对象，可以为空
+ * @param sideLength 要生成的二维码的边长，如果为空，则取默认值400
+ * @return 生成的二维码的字节数组
+ */
+ public byte[] createScanPayQrcodeMode2(String codeUrl, File logoFile, Integer sideLength) throws Exception {
+ return this.wxService.createScanPayQrcodeMode2(codeUrl, logoFile, sideLength);
+ }
- @Operation(summary = "下载对账单")
- @PostMapping("/downloadBill")
- public WxPayBillResult downloadBill(WxPayDownloadBillRequest wxPayDownloadBillRequest) throws WxPayException {
- return this.wxService.downloadBill(wxPayDownloadBillRequest);
- }
+ /**
+ *
+ * 交易保障
+ * 应用场景：
+ * 商户在调用微信支付提供的相关接口时，会得到微信支付返回的相关信息以及获得整个接口的响应时间。
+ * 为提高整体的服务水平，协助商户一起提高服务质量，微信支付提供了相关接口调用耗时和返回信息的主动上报接口，
+ * 微信支付可以根据商户侧上报的数据进一步优化网络部署，完善服务监控，和商户更好的协作为用户提供更好的业务体验。
+ * 接口地址： https://api.mch.weixin.qq.com/payitil/report
+ * 是否需要证书：不需要
+ *
+ */
+ @Operation(summary = "提交交易保障数据")
+ @PostMapping("/report")
+ public void report(@RequestBody WxPayReportRequest request) throws WxPayException {
+ this.wxService.report(request);
+ }
- /**
- *
- * 提交刷卡支付
- * 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_10&index=1
- * 应用场景：
- * 收银员使用扫码设备读取微信用户刷卡授权码以后，二维码或条码信息传送至商户收银台，由商户收银台或者商户后台调用该接口发起支付。
- * 提醒1：提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)；
- * 提醒2：在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。
- * 接口地址： https://api.mch.weixin.qq.com/pay/micropay
- * 是否需要证书：不需要。
- *
- */
- @Operation(summary = "提交刷卡支付")
- @PostMapping("/micropay")
- public WxPayMicropayResult micropay(@RequestBody WxPayMicropayRequest request) throws WxPayException {
- return this.wxService.micropay(request);
- }
+ /**
+ *
+ * 下载对账单
+ * 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。
+ * 注意：
+ * 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致，bill_type为REVOKED；
+ * 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取；
+ * 3、对账单中涉及金额的字段单位为“元”。
+ * 4、对账单接口只能下载三个月以内的账单。
+ * 接口链接：https://api.mch.weixin.qq.com/pay/downloadbill
+ * 详情请见: 下载对账单
+ *
+ *
+ * @param billDate 对账单日期 bill_date 下载对账单的日期，格式：20140603
+ * @param billType 账单类型 bill_type
+ * ALL，返回当日所有订单信息，默认值，SUCCESS，返回当日成功支付的订单，REFUND，返回当日退款订单
+ * @param tarType 压缩账单 tar_type 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。
+ * @param deviceInfo 设备号 device_info 非必传参数，终端设备号
+ * @return 保存到本地的临时文件
+ */
+ @Operation(summary = "下载对账单")
+ @GetMapping("/downloadBill/{billDate}/{billType}/{tarType}/{deviceInfo}")
+ public WxPayBillResult downloadBill(@PathVariable String billDate, @PathVariable String billType,
+ @PathVariable String tarType, @PathVariable String deviceInfo) throws WxPayException {
+ return this.wxService.downloadBill(billDate, billType, tarType, deviceInfo);
+ }
- /**
- *
- * 撤销订单API
- * 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_11&index=3
- * 应用场景：
- * 支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，微信支付系统会将此订单关闭；如果用户支付成功，微信支付系统会将此订单资金退还给用户。
- * 注意：7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。
- * 调用支付接口后请勿立即调用撤销订单API，建议支付后至少15s后再调用撤销订单接口。
- * 接口链接 ：https://api.mch.weixin.qq.com/secapi/pay/reverse
- * 是否需要证书：请求需要双向证书。
- *
- */
- @Operation(summary = "撤销订单")
- @PostMapping("/reverseOrder")
- public WxPayOrderReverseResult reverseOrder(@RequestBody WxPayOrderReverseRequest request) throws WxPayException {
- return this.wxService.reverseOrder(request);
- }
+ @Operation(summary = "下载对账单")
+ @PostMapping("/downloadBill")
+ public WxPayBillResult downloadBill(WxPayDownloadBillRequest wxPayDownloadBillRequest) throws WxPayException {
+ return this.wxService.downloadBill(wxPayDownloadBillRequest);
+ }
- @Operation(summary = "获取沙箱环境签名key")
- @GetMapping("/getSandboxSignKey")
- public String getSandboxSignKey() throws WxPayException {
- return this.wxService.getSandboxSignKey();
- }
+ /**
+ *
+ * 提交刷卡支付
+ * 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_10&index=1
+ * 应用场景：
+ * 收银员使用扫码设备读取微信用户刷卡授权码以后，二维码或条码信息传送至商户收银台，由商户收银台或者商户后台调用该接口发起支付。
+ * 提醒1：提交支付请求后微信会同步返回支付结果。当返回结果为“系统错误”时，商户系统等待5秒后调用【查询订单API】，查询支付实际交易结果；当返回结果为“USERPAYING”时，商户系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议30秒)；
+ * 提醒2：在调用查询接口返回后，如果交易状况不明晰，请调用【撤销订单API】，此时如果交易失败则关闭订单，该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误时，请再次调用。注意：请勿扣款后立即调用【撤销订单API】,建议至少15秒后再调用。撤销订单API需要双向证书。
+ * 接口地址： https://api.mch.weixin.qq.com/pay/micropay
+ * 是否需要证书：不需要。
+ *
+ */
+ @Operation(summary = "提交刷卡支付")
+ @PostMapping("/micropay")
+ public WxPayMicropayResult micropay(@RequestBody WxPayMicropayRequest request) throws WxPayException {
+ return this.wxService.micropay(request);
+ }
- @Operation(summary = "发放代金券")
- @PostMapping("/sendCoupon")
- public WxPayCouponSendResult sendCoupon(@RequestBody WxPayCouponSendRequest request) throws WxPayException {
- return this.wxService.sendCoupon(request);
- }
+ /**
+ *
+ * 撤销订单API
+ * 文档地址：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_11&index=3
+ * 应用场景：
+ * 支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，微信支付系统会将此订单关闭；如果用户支付成功，微信支付系统会将此订单资金退还给用户。
+ * 注意：7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。
+ * 调用支付接口后请勿立即调用撤销订单API，建议支付后至少15s后再调用撤销订单接口。
+ * 接口链接 ：https://api.mch.weixin.qq.com/secapi/pay/reverse
+ * 是否需要证书：请求需要双向证书。
+ *
+ */
+ @Operation(summary = "撤销订单")
+ @PostMapping("/reverseOrder")
+ public WxPayOrderReverseResult reverseOrder(@RequestBody WxPayOrderReverseRequest request) throws WxPayException {
+ return this.wxService.reverseOrder(request);
+ }
- @Operation(summary = "查询代金券批次")
- @PostMapping("/queryCouponStock")
- public WxPayCouponStockQueryResult queryCouponStock(@RequestBody WxPayCouponStockQueryRequest request) throws WxPayException {
- return this.wxService.queryCouponStock(request);
- }
+ @Operation(summary = "获取沙箱环境签名key")
+ @GetMapping("/getSandboxSignKey")
+ public String getSandboxSignKey() throws WxPayException {
+ return this.wxService.getSandboxSignKey();
+ }
- @Operation(summary = "查询代金券信息")
- @PostMapping("/queryCouponInfo")
- public WxPayCouponInfoQueryResult queryCouponInfo(@RequestBody WxPayCouponInfoQueryRequest request) throws WxPayException {
- return this.wxService.queryCouponInfo(request);
- }
+ @Operation(summary = "发放代金券")
+ @PostMapping("/sendCoupon")
+ public WxPayCouponSendResult sendCoupon(@RequestBody WxPayCouponSendRequest request) throws WxPayException {
+ return this.wxService.sendCoupon(request);
+ }
- @Operation(summary = "拉取订单评价数据")
- @PostMapping("/queryComment")
- public String queryComment(Date beginDate, Date endDate, Integer offset, Integer limit) throws WxPayException {
- return this.wxService.queryComment(beginDate, endDate, offset, limit);
- }
+ @Operation(summary = "查询代金券批次")
+ @PostMapping("/queryCouponStock")
+ public WxPayCouponStockQueryResult queryCouponStock(@RequestBody WxPayCouponStockQueryRequest request)
+ throws WxPayException {
+ return this.wxService.queryCouponStock(request);
+ }
+
+ @Operation(summary = "查询代金券信息")
+ @PostMapping("/queryCouponInfo")
+ public WxPayCouponInfoQueryResult queryCouponInfo(@RequestBody WxPayCouponInfoQueryRequest request)
+ throws WxPayException {
+ return this.wxService.queryCouponInfo(request);
+ }
+
+ @Operation(summary = "拉取订单评价数据")
+ @PostMapping("/queryComment")
+ public String queryComment(Date beginDate, Date endDate, Integer offset, Integer limit) throws WxPayException {
+ return this.wxService.queryComment(beginDate, endDate, offset, limit);
+ }
}
\ No newline at end of file
diff --git a/wfc-modules/wfc-payment/src/main/resources/application.yml b/wfc-modules/wfc-payment/src/main/resources/application.yml
index ee72c43..4dee56b 100644
--- a/wfc-modules/wfc-payment/src/main/resources/application.yml
+++ b/wfc-modules/wfc-payment/src/main/resources/application.yml
@@ -55,7 +55,7 @@ spring:
# mybatis-plus配置
mybatis-plus:
# 搜索指定包别名
- type-aliases-package: org.wfc.system
+ type-aliases-package: org.wfc.payment.*.model
# 配置mapper的扫描，找到所有的mapper.xml映射文件
mapper-locations: classpath:mapper/**/*.xml
global-config:
@@ -72,19 +72,13 @@ swagger:
logging:
level:
- root: debug
- org:
- springframework:
- web: debug
- mybatis:
- mapper: debug
- wfc:
- system: debug
- com:
- github:
- binarywang: debug
- file:
- name: /opt/wfc/logs/wfc-payment.log
+ root: info
+ org.springframework.web: info
+ org.mybatis.mapper: debug
+ com.github.binarywang: debug
+ org.wfc.payment.wxpay: debug
+ org.wfc.payment.alipay: debug
+ org.wfc.payment.ccpay: debug
wxpay:
appId: 121412414112
@@ -104,7 +98,7 @@ alipay:
signType: RSA2
charset: utf-8
gatewayUrl: https://openapi.alipaydev.com/gateway.do
- logPath: /opt/wfc/logs/alipay/alipay_log.txt
+ logPath: /opt/wfc/logs/alipay/alipay.log
maxQueryRetry: 5
queryDuration: 5
maxCancelRetry: 3
@@ -117,9 +111,45 @@ alipay:
supportPhone:
ccpay:
- url: https://api.paymentgateway.com/v1/payments
+ paymentUrl: https://api.paymentgateway.com/v1/payment
+ tokenUrl: https://api.paymentgateway.com/v1/token
+ queryUrl: https://api.paymentgateway.com/v1/query
+ refundUrl: https://api.paymentgateway.com/v1/refund
apiKey: api-key
merchantId: merchant-id
currency: USD
timeout: 30
- callbackUrl: https://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/payment/callback
\ No newline at end of file
+ callbackUrl: https://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/payment/callback
+
+unionpay:
+ merId: 700000000000001
+ keyPrivateCert: /opt/wfc/conf/cert/unionpay/wfc-union.pfx
+ keyPrivateCertPwd: 123456
+ signCertType: PKCS12
+ encryptCertPath: /opt/wfc/conf/cert/unionpay/wfc-union.cer
+ acpMiddleCert: /opt/wfc/conf/cert/unionpay/wfc-middle.cer
+ acpRootCert: /opt/wfc/conf/cert/unionpay/wfc-root.cer
+ frontUrl: https://gateway.test.95516.com/gateway/api/frontTransReq.do
+ backUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/notify
+ signMethod: 01
+ version: 5.1.0
+ channelType: 07
+ accessType: 0
+ currencyCode: 156
+ bizType: 000201
+ txnType: 01
+ txnSubType: 01
+ payTimeout: 30
+ queryTimeout: 30
+ refundTimeout: 30
+ frontFailUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/fail
+ frontSuccessUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/success
+ frontBackUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/front
+ backBackUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/back
+ frontNotifyUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/front/notify
+ backNotifyUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/back/notify
+ refundNotifyUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/refund/notify
+ queryNotifyUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/query/notify
+ refundSuccessUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/refund/success
+ refundFailUrl: http://wfc-gateway:${GATEWAY_SERVER_PORT:8080}/unionpay/refund/fail
+ querySuccessUrl:
\ No newline at end of file
diff --git a/wfc-modules/wfc-payment/src/main/resources/mapper/payment/AliPayMapper.xml b/wfc-modules/wfc-payment/src/main/resources/mapper/payment/AliPayMapper.xml
deleted file mode 100644
index 6542d0b..0000000
--- a/wfc-modules/wfc-payment/src/main/resources/mapper/payment/AliPayMapper.xml
+++ /dev/null
@@ -1,103 +0,0 @@
-
-
-