PaymentOrderService.java 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436
  1. package com.xuekairui.payment.service;
  2. import cn.hutool.core.util.IdUtil;
  3. import com.alipay.api.AlipayClient;
  4. import com.alipay.api.domain.AlipayTradePrecreateModel;
  5. import com.alipay.api.request.AlipayTradePrecreateRequest;
  6. import com.alipay.api.response.AlipayTradePrecreateResponse;
  7. import com.github.binarywang.wxpay.bean.request.WxPayUnifiedOrderV3Request;
  8. import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
  9. import com.github.binarywang.wxpay.service.WxPayService;
  10. import com.xuekairui.common.BusinessException;
  11. import com.xuekairui.common.ErrorCode;
  12. import com.xuekairui.payment.config.PaymentProperties;
  13. import com.xuekairui.payment.dto.CreateOrderRequest;
  14. import com.xuekairui.payment.dto.OrderResponse;
  15. import com.xuekairui.payment.dto.PaymentResultResponse;
  16. import com.xuekairui.payment.entity.PaymentOrder;
  17. import com.xuekairui.payment.entity.PaymentPlan;
  18. import com.xuekairui.payment.enums.PaymentChannel;
  19. import com.xuekairui.payment.enums.PaymentStatus;
  20. import com.xuekairui.payment.mapper.PaymentOrderMapper;
  21. import com.xuekairui.user.entity.UserMembership;
  22. import com.xuekairui.user.enums.MembershipLevel;
  23. import com.xuekairui.user.service.MembershipService;
  24. import lombok.RequiredArgsConstructor;
  25. import lombok.extern.slf4j.Slf4j;
  26. import org.springframework.beans.factory.ObjectProvider;
  27. import org.springframework.scheduling.annotation.Scheduled;
  28. import org.springframework.stereotype.Service;
  29. import org.springframework.transaction.annotation.Transactional;
  30. import java.time.LocalDateTime;
  31. import java.util.List;
  32. import java.util.stream.Collectors;
  33. /**
  34. * 支付订单服务
  35. */
  36. @Slf4j
  37. @Service
  38. @RequiredArgsConstructor
  39. public class PaymentOrderService {
  40. private final PaymentOrderMapper paymentOrderMapper;
  41. private final PaymentPlanService paymentPlanService;
  42. private final QRCodeService qrCodeService;
  43. private final MembershipService membershipService;
  44. private final PaymentProperties paymentProperties;
  45. private final ObjectProvider<AlipayClient> alipayClientProvider;
  46. private final ObjectProvider<WxPayService> wxPayServiceProvider;
  47. /**
  48. * 创建支付订单
  49. */
  50. @Transactional
  51. public OrderResponse createOrder(Long userId, CreateOrderRequest request) {
  52. // 校验渠道
  53. PaymentChannel channel = PaymentChannel.fromCode(request.getChannel());
  54. if (channel == null) {
  55. throw new BusinessException(ErrorCode.PAY_CHANNEL_NOT_SUPPORT,
  56. "支持的渠道:WECHAT, ALIPAY");
  57. }
  58. // 获取方案
  59. PaymentPlan plan = paymentPlanService.getEnabledPlanById(request.getPlanId());
  60. // 生成订单号
  61. String orderNo = "OP" + IdUtil.getSnowflake(1, 1).nextIdStr();
  62. // 过期时间
  63. LocalDateTime expireTime = LocalDateTime.now()
  64. .plusMinutes(paymentProperties.getOrderExpireMinutes());
  65. // 生成支付二维码/链接
  66. String qrContent;
  67. String payUrl = null;
  68. if (paymentProperties.isMock()) {
  69. qrContent = "MOCK_PAY:" + orderNo;
  70. } else {
  71. // 生产模式:调用对应渠道预下单接口获取支付链接
  72. PrepayResult prepayResult = createPrepay(channel, orderNo, plan.getPrice(), plan.getPlanName(), plan.getDescription());
  73. qrContent = prepayResult.getQrContent();
  74. payUrl = prepayResult.getPayUrl();
  75. }
  76. // 仅在有二维码内容时生成二维码图片(微信Native/支付宝precreate均返回qrContent,由后端统一生成base64)
  77. String qrCodeBase64 = (qrContent != null && !qrContent.isEmpty())
  78. ? qrCodeService.generateBase64(qrContent) : null;
  79. // 保存订单
  80. PaymentOrder order = PaymentOrder.builder()
  81. .orderNo(orderNo)
  82. .userId(userId)
  83. .planId(plan.getId())
  84. .amount(plan.getPrice())
  85. .channel(request.getChannel())
  86. .status(PaymentStatus.PENDING.name())
  87. .qrCodeUrl(qrContent)
  88. .expireTime(expireTime)
  89. .build();
  90. paymentOrderMapper.insert(order);
  91. log.info("创建支付订单: {} 用户={} 方案={} 金额={}元 渠道={}",
  92. orderNo, userId, plan.getPlanName(), plan.getPrice(), channel.getDisplayName());
  93. return OrderResponse.builder()
  94. .orderNo(orderNo)
  95. .planName(plan.getPlanName())
  96. .amount(order.getAmount())
  97. .channel(order.getChannel())
  98. .status(order.getStatus())
  99. .qrCodeBase64(qrCodeBase64)
  100. .payUrl(payUrl)
  101. .expireTime(order.getExpireTime())
  102. .expireHint("请在" + paymentProperties.getOrderExpireMinutes() + "分钟内完成付款,超时订单将自动过期")
  103. .createTime(order.getCreateTime())
  104. .build();
  105. }
  106. /**
  107. * 查询单个订单(自动检查过期)
  108. */
  109. public OrderResponse queryOrder(String orderNo) {
  110. PaymentOrder order = paymentOrderMapper.selectByOrderNo(orderNo);
  111. if (order == null) {
  112. throw new BusinessException(ErrorCode.PAY_ORDER_NOT_FOUND);
  113. }
  114. checkExpired(order);
  115. return toResponse(order);
  116. }
  117. /**
  118. * 查询用户的所有订单
  119. */
  120. public List<OrderResponse> listUserOrders(Long userId) {
  121. List<PaymentOrder> orders = paymentOrderMapper.selectByUserId(userId);
  122. orders.forEach(this::checkExpired);
  123. return orders.stream().map(this::toResponse).collect(Collectors.toList());
  124. }
  125. /**
  126. * 手动确认支付(开发/测试用)
  127. * <p>
  128. * mock模式:模拟支付,自动生成交易号
  129. * 真实支付模式:手动确认支付(用于测试回调流程,不实际扣款)
  130. * </p>
  131. */
  132. @Transactional
  133. public PaymentResultResponse confirmPay(String orderNo) {
  134. PaymentOrder order = paymentOrderMapper.selectByOrderNo(orderNo);
  135. if (order == null) {
  136. throw new BusinessException(ErrorCode.PAY_ORDER_NOT_FOUND);
  137. }
  138. if (PaymentStatus.PAID.name().equals(order.getStatus())) {
  139. throw new BusinessException(ErrorCode.PAY_FAILED, "该订单已支付");
  140. }
  141. if (PaymentStatus.EXPIRED.name().equals(order.getStatus())) {
  142. throw new BusinessException(ErrorCode.PAY_ORDER_EXPIRED);
  143. }
  144. String prefix = paymentProperties.isMock() ? "MOCK_" : "MANUAL_";
  145. String tradeNo = prefix + IdUtil.fastSimpleUUID().substring(0, 16).toUpperCase();
  146. return processPaidCallback(orderNo, tradeNo);
  147. }
  148. /**
  149. * 支付回调处理(微信/支付宝回调统一入口)
  150. * @param orderNo 订单号
  151. * @param tradeNo 第三方交易号
  152. * @return 支付结果
  153. */
  154. @Transactional
  155. public PaymentResultResponse processPaidCallback(String orderNo, String tradeNo) {
  156. PaymentOrder order = paymentOrderMapper.selectByOrderNo(orderNo);
  157. if (order == null) {
  158. throw new BusinessException(ErrorCode.PAY_ORDER_NOT_FOUND);
  159. }
  160. // 幂等:已支付直接返回
  161. if (PaymentStatus.PAID.name().equals(order.getStatus())) {
  162. PaymentPlan plan = paymentPlanService.getPlanById(order.getPlanId());
  163. return buildResultResponse(order, plan);
  164. }
  165. if (PaymentStatus.EXPIRED.name().equals(order.getStatus())) {
  166. throw new BusinessException(ErrorCode.PAY_ORDER_EXPIRED);
  167. }
  168. return handlePaymentSuccess(order, tradeNo);
  169. }
  170. /**
  171. * 支付成功处理
  172. */
  173. private PaymentResultResponse handlePaymentSuccess(PaymentOrder order, String tradeNo) {
  174. PaymentPlan plan = paymentPlanService.getPlanById(order.getPlanId());
  175. MembershipLevel level = MembershipLevel.fromCode(plan.getMembershipLevel());
  176. // 更新订单状态
  177. LocalDateTime now = LocalDateTime.now();
  178. order.setStatus(PaymentStatus.PAID.name());
  179. order.setPaidTime(now);
  180. order.setTradeNo(tradeNo);
  181. paymentOrderMapper.updateById(order);
  182. // 激活会员(叠加模式:保留低级别剩余时长)
  183. UserMembership membership = membershipService.activateFromPayment(
  184. order.getUserId(), level, plan.getDurationDays(), order.getOrderNo());
  185. // 关联会员记录
  186. order.setMembershipRecordId(membership.getId());
  187. paymentOrderMapper.updateById(order);
  188. log.info("支付成功: {} 用户={} 方案={} 金额={}元 会员={} 交易号={}",
  189. order.getOrderNo(), order.getUserId(),
  190. plan.getPlanName(), order.getAmount(), level.getCode(), tradeNo);
  191. return buildResultResponse(order, plan);
  192. }
  193. private PaymentResultResponse buildResultResponse(PaymentOrder order, PaymentPlan plan) {
  194. return PaymentResultResponse.builder()
  195. .orderNo(order.getOrderNo())
  196. .status(PaymentStatus.PAID.name())
  197. .amount(order.getAmount())
  198. .planName(plan.getPlanName())
  199. .membershipLevel(plan.getMembershipLevel())
  200. .paidTime(order.getPaidTime())
  201. .membershipStartDate(null)
  202. .membershipEndDate(null)
  203. .build();
  204. }
  205. /**
  206. * 检查并自动过期订单
  207. */
  208. private void checkExpired(PaymentOrder order) {
  209. if (PaymentStatus.PENDING.name().equals(order.getStatus())
  210. && LocalDateTime.now().isAfter(order.getExpireTime())) {
  211. order.setStatus(PaymentStatus.EXPIRED.name());
  212. paymentOrderMapper.updateById(order);
  213. log.info("订单 {} 已自动过期", order.getOrderNo());
  214. }
  215. }
  216. /**
  217. * 定时清理过期订单(每分钟)
  218. */
  219. @Scheduled(fixedDelay = 60000)
  220. @Transactional
  221. public void cleanupExpiredOrders() {
  222. List<PaymentOrder> expiredOrders = paymentOrderMapper
  223. .selectExpiredPending(LocalDateTime.now());
  224. for (PaymentOrder order : expiredOrders) {
  225. order.setStatus(PaymentStatus.EXPIRED.name());
  226. paymentOrderMapper.updateById(order);
  227. }
  228. if (!expiredOrders.isEmpty()) {
  229. log.info("定时清理过期订单: {} 笔", expiredOrders.size());
  230. }
  231. }
  232. /**
  233. * 生产模式预下单结果
  234. */
  235. @lombok.Data
  236. @lombok.Builder
  237. @lombok.NoArgsConstructor
  238. @lombok.AllArgsConstructor
  239. private static class PrepayResult {
  240. /** 二维码内容(用于本地生成二维码图片) */
  241. private String qrContent;
  242. /** 支付跳转URL(前端可直接跳转,H5支付场景) */
  243. private String payUrl;
  244. }
  245. /**
  246. * 调用第三方支付预下单接口
  247. *
  248. * <p>上线时替换为真实SDK调用:
  249. * <ul>
  250. * <li>微信:使用 weixin-java-pay 的 WxPayService.createOrder() 获取 code_url</li>
  251. * <li>支付宝:使用 alipay-sdk-java 的 AlipayClient.pageExecute() 获取支付跳转链接</li>
  252. * </ul>
  253. *
  254. * @param channel 支付渠道
  255. * @param orderNo 订单号
  256. * @param amount 金额
  257. * @param subject 商品标题
  258. * @param body 商品详细描述
  259. * @return 预下单结果
  260. */
  261. private PrepayResult createPrepay(PaymentChannel channel, String orderNo,
  262. java.math.BigDecimal amount, String subject, String body) {
  263. return switch (channel) {
  264. case WECHAT -> createWechatPrepay(orderNo, amount, subject);
  265. case ALIPAY -> createAlipayPrepay(orderNo, amount, subject, body);
  266. };
  267. }
  268. /**
  269. * 微信Native支付预下单(API v3)
  270. *
  271. * <p>使用 WxJava SDK 调用微信支付 v3 Native下单接口,
  272. * 返回 codeUrl(二维码链接),前端可直接生成二维码展示。
  273. * 用户扫码后在微信App中完成付款,微信异步回调 notifyUrl。
  274. */
  275. private PrepayResult createWechatPrepay(String orderNo, java.math.BigDecimal amount, String subject) {
  276. PaymentProperties.Wechat wc = paymentProperties.getWechat();
  277. if (wc.getAppId() == null || wc.getMchId() == null) {
  278. throw new BusinessException(ErrorCode.PAY_CHANNEL_NOT_CONFIGURED,
  279. "微信支付未配置,请检查 payment.wechat 参数");
  280. }
  281. WxPayService wxPayService = wxPayServiceProvider.getIfAvailable();
  282. if (wxPayService == null) {
  283. throw new BusinessException(ErrorCode.PAY_CHANNEL_NOT_CONFIGURED,
  284. "WxPayService未初始化,请确认 payment.mock=false 且已配置微信支付参数");
  285. }
  286. try {
  287. WxPayUnifiedOrderV3Request request = new WxPayUnifiedOrderV3Request();
  288. request.setOutTradeNo(orderNo);
  289. request.setDescription(subject);
  290. request.setNotifyUrl(wc.getNotifyUrl());
  291. // 金额单位为分
  292. WxPayUnifiedOrderV3Request.Amount amountObj = new WxPayUnifiedOrderV3Request.Amount();
  293. amountObj.setTotal(amount.movePointRight(2).intValue());
  294. amountObj.setCurrency("CNY");
  295. request.setAmount(amountObj);
  296. // 过期时间(RFC3339格式)
  297. String timeExpire = java.time.format.DateTimeFormatter
  298. .ofPattern("yyyy-MM-dd'T'HH:mm:ssXXX")
  299. .format(java.time.ZonedDateTime.now()
  300. .plusMinutes(paymentProperties.getOrderExpireMinutes()));
  301. request.setTimeExpire(timeExpire);
  302. // WxJava 4.7.0: NATIVE 模式下 createOrderV3 直接返回 code_url 字符串
  303. String codeUrl = wxPayService.createOrderV3(TradeTypeEnum.NATIVE, request);
  304. log.info("微信预下单成功: orderNo={}, amount={}, codeUrl={}", orderNo, amount, codeUrl);
  305. return PrepayResult.builder()
  306. .qrContent(codeUrl)
  307. .payUrl(codeUrl)
  308. .build();
  309. } catch (BusinessException e) {
  310. throw e;
  311. } catch (Exception e) {
  312. log.error("微信预下单异常: orderNo={}", orderNo, e);
  313. throw new BusinessException(ErrorCode.PAY_FAILED, "微信下单异常: " + e.getMessage());
  314. }
  315. }
  316. /**
  317. * 支付宝当面付预下单(alipay.trade.precreate)
  318. *
  319. * <p>调用支付宝「统一收单线下交易预创建」接口,生成支付码串(qr_code),
  320. * 后端将其转换为二维码 base64 图片,前端在自定义弹窗中展示。
  321. * 用户用支付宝 App 扫码完成付款,支付宝异步回调 notifyUrl 通知支付结果。
  322. *
  323. * @see <a href="https://opendocs.alipay.com/open/02ekfh">统一收单线下交易预创建</a>
  324. */
  325. private PrepayResult createAlipayPrepay(String orderNo, java.math.BigDecimal amount, String subject, String body) {
  326. PaymentProperties.Alipay al = paymentProperties.getAlipay();
  327. if (al.getAppId() == null || al.getAppPrivateKey() == null) {
  328. throw new BusinessException(ErrorCode.PAY_CHANNEL_NOT_CONFIGURED,
  329. "支付宝未配置,请检查 payment.alipay 参数");
  330. }
  331. AlipayClient alipayClient = alipayClientProvider.getIfAvailable();
  332. if (alipayClient == null) {
  333. throw new BusinessException(ErrorCode.PAY_CHANNEL_NOT_CONFIGURED,
  334. "AlipayClient未初始化,请确认 payment.mock=false 且已配置支付宝参数");
  335. }
  336. AlipayTradePrecreateRequest request = new AlipayTradePrecreateRequest();
  337. request.setNotifyUrl(al.getNotifyUrl());
  338. AlipayTradePrecreateModel model = new AlipayTradePrecreateModel();
  339. model.setOutTradeNo(orderNo);
  340. model.setTotalAmount(amount.toPlainString());
  341. model.setSubject(subject);
  342. if (body != null && !body.isBlank()) {
  343. model.setBody(body);
  344. }
  345. model.setProductCode("QR_CODE_OFFLINE");
  346. model.setTimeoutExpress(paymentProperties.getOrderExpireMinutes() + "m");
  347. request.setBizModel(model);
  348. try {
  349. // 公钥模式用 execute(),证书模式用 certificateExecute()
  350. boolean publicKeyMode = al.getAlipayPublicKey() != null && !al.getAlipayPublicKey().isBlank();
  351. AlipayTradePrecreateResponse response = publicKeyMode
  352. ? alipayClient.execute(request)
  353. : alipayClient.certificateExecute(request);
  354. if (!response.isSuccess()) {
  355. log.error("支付宝预下单失败: orderNo={}, code={}, msg={}, subCode={}, subMsg={}",
  356. orderNo, response.getCode(), response.getMsg(),
  357. response.getSubCode(), response.getSubMsg());
  358. throw new BusinessException(ErrorCode.PAY_FAILED,
  359. "支付宝下单失败: " + response.getSubMsg());
  360. }
  361. String qrCode = response.getQrCode();
  362. log.info("支付宝预下单成功: orderNo={}, amount={}, qrCode={}", orderNo, amount, qrCode);
  363. // 返回 qr_code 支付码串,后端生成base64二维码,前端在自定义弹窗中展示
  364. return PrepayResult.builder()
  365. .qrContent(qrCode)
  366. .payUrl(qrCode)
  367. .build();
  368. } catch (BusinessException e) {
  369. throw e;
  370. } catch (Exception e) {
  371. log.error("支付宝预下单异常: orderNo={}", orderNo, e);
  372. throw new BusinessException(ErrorCode.PAY_FAILED, "支付宝下单异常: " + e.getMessage());
  373. }
  374. }
  375. private OrderResponse toResponse(PaymentOrder order) {
  376. String hint = PaymentStatus.PENDING.name().equals(order.getStatus())
  377. ? "请在" + paymentProperties.getOrderExpireMinutes() + "分钟内完成付款,超时订单将自动过期" : null;
  378. return OrderResponse.builder()
  379. .orderNo(order.getOrderNo())
  380. .planName(null) // 由调用方补充
  381. .amount(order.getAmount())
  382. .channel(order.getChannel())
  383. .status(order.getStatus())
  384. .qrCodeBase64(null)
  385. .payUrl(null) // 查询场景不再返回,仅创建时提供
  386. .expireTime(order.getExpireTime())
  387. .expireHint(hint)
  388. .createTime(order.getCreateTime())
  389. .build();
  390. }
  391. }