From 295e80a20eb63edf45734501ebc698e14c9c1729 Mon Sep 17 00:00:00 2001 From: lik Date: Fri, 6 Nov 2026 22:20:04 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E7=AE=A1=E7=90=86=E7=AB=AF=E6=94=AF?= =?UTF-8?q?=E6=8C=81=E5=86=8D=E6=AC=A1=E5=8F=91=E8=B5=B7=E8=AE=A2=E5=8D=95?= =?UTF-8?q?=E9=80=80=E6=AC=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 退款失败或结果不明时可按原退款单号幂等重试,避免只能转人工核销。 --- handler/payment.js | 86 +++++++++++++++++++++++++++++++++++----------- routes/index.js | 2 ++ 2 files changed, 68 insertions(+), 20 deletions(-) diff --git a/handler/payment.js b/handler/payment.js index 77f6c9e..b50ab09 100644 --- a/handler/payment.js +++ b/handler/payment.js @@ -346,8 +346,9 @@ class HandlerPayment { /** * 取消已支付订单的自动原路退款(一单一笔全额退款,outRefundNo 固定 -R1) * 先落 refund_record(processing) 再调接口;超时/系统异常先查退款,未受理则原单号重试一次。 + * retry=true 时允许对已存在的退款流水按同一 outRefundNo 再次发起(微信对该单号幂等)。 */ - static async createRefundForRecord(record, { reason } = {}) { + static async createRefundForRecord(record, { reason, retry = false } = {}) { const recordId = record?._id ? String(record._id) : ""; if (!isValidObjectId(recordId)) return { skipped: true }; @@ -373,8 +374,8 @@ class HandlerPayment { }); return existing; } - // processing 不重复调接口;abnormal/closed 转人工 - return existing; + // 默认 processing 不重复调接口;abnormal/closed 转人工;retry=true 时按同号重试 + if (!retry) return existing; } if (!wxpay.isConfigured()) { @@ -382,25 +383,33 @@ class HandlerPayment { return { skipped: true }; } - const refundReason = String(reason || record?.cancelReason || DEFAULT_REFUND_REASON).slice(0, 120); + const refundReason = String(reason || record?.cancelReason || existing?.reason || DEFAULT_REFUND_REASON).slice(0, 120); let refundRecord; - try { - refundRecord = await DBModel.RefundRecord.create({ - paymentId: payment._id, - recordId: payment.recordId, - outTradeNo: payment.outTradeNo, - outRefundNo, - refundAmount: Number(payment.totalFee) || 0, - totalAmount: Number(payment.totalFee) || 0, - reason: refundReason, - status: "processing", - createdAt: new Date(), - }); - } catch (err) { - if (err?.code === 11000) { - return await DBModel.RefundRecord.findOne({ outRefundNo }); + if (existing) { + await DBModel.RefundRecord.updateOne( + { _id: existing._id }, + { $set: { reason: refundReason, lastAttemptAt: new Date(), "meta.updatetime": nowMs() } } + ); + refundRecord = await DBModel.RefundRecord.findById(existing._id); + } else { + try { + refundRecord = await DBModel.RefundRecord.create({ + paymentId: payment._id, + recordId: payment.recordId, + outTradeNo: payment.outTradeNo, + outRefundNo, + refundAmount: Number(payment.totalFee) || 0, + totalAmount: Number(payment.totalFee) || 0, + reason: refundReason, + status: "processing", + createdAt: new Date(), + }); + } catch (err) { + if (err?.code === 11000) { + return await DBModel.RefundRecord.findOne({ outRefundNo }); + } + throw err; } - throw err; } // 先落库再调外部接口,并先把订单快照置为退款中 @@ -962,6 +971,43 @@ class HandlerPayment { return ResponseUtil.internalError(ctx, err); } } + + /** + * POST /escort-record/:id/refund/retry (管理端) + * 退款失败或结果不明时,按同一 outRefundNo 再次发起微信原路退款(微信幂等) + */ + async retryRefund(ctx) { + try { + const id = ctx.params.id; + if (!isValidObjectId(id)) return ResponseUtil.badRequest(ctx, "缺少记录ID"); + const record = await DBModel.EscortRecord.findById(id); + if (!record || record.deletedAt) return ResponseUtil.error(ctx, "陪诊记录不存在", null, 404); + if ((record.payment?.status || "unpaid") !== "refunding") { + return ResponseUtil.badRequest(ctx, "当前订单不在退款中"); + } + + const existing = await DBModel.RefundRecord.findOne({ recordId: record._id, outRefundNo: `${record._id}-R1` }); + if (existing?.status === "success") { + return ResponseUtil.badRequest(ctx, "该订单退款已成功,无需再次退款"); + } + + const refund = await HandlerPayment.createRefundForRecord(record, { retry: true }); + if (refund?.skipped) { + return ResponseUtil.badRequest(ctx, "缺少成功支付流水,无法发起线上退款,请人工核销"); + } + + const freshRecord = await DBModel.EscortRecord.findById(id); + return ResponseUtil.success(ctx, { + refund: refund ? refund.toObject() : null, + paymentStatus: freshRecord?.payment?.status || "unpaid", + }, "已重新发起退款"); + } catch (err) { + logger.error( + `[payment] 再次退款失败 recordId=${ctx.params.id} code=${err?.code || ""} requestId=${err?.requestId || ""} message=${err?.message || ""}` + ); + return ResponseUtil.error(ctx, "再次退款失败,请稍后重试或人工核销", null, 500); + } + } } // ==================== 后台巡检查单 ==================== diff --git a/routes/index.js b/routes/index.js index 37ca74b..551329a 100644 --- a/routes/index.js +++ b/routes/index.js @@ -99,6 +99,8 @@ function registerRoutes(app) { router.post("/escort-record/:id/pay", requireAuth, createLimit, handlerPayment.createPayment.bind(handlerPayment)); router.get("/escort-record/:id/pay/status", requireAuth, handlerPayment.queryPayment.bind(handlerPayment)); router.post("/escort-record/:id/refund/query", requireAuth, requireAdmin, handlerPayment.queryRefundResult.bind(handlerPayment)); + // 退款失败/结果不明时按同一退款单号再次发起 + router.post("/escort-record/:id/refund/retry", requireAuth, requireAdmin, handlerPayment.retryRefund.bind(handlerPayment)); // 线下/人工退款核销:由平台确认已退款后把订单置为 refunded router.post("/escort-record/:id/refund/manual", requireAuth, requireAdmin, handlerPayment.completeManualRefund.bind(handlerPayment));