feat: 管理端支持再次发起订单退款

退款失败或结果不明时可按原退款单号幂等重试,避免只能转人工核销。
This commit is contained in:
lik
2026-11-06 22:20:04 +08:00
parent adaf10376d
commit 295e80a20e
2 changed files with 68 additions and 20 deletions
+66 -20
View File
@@ -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);
}
}
}
// ==================== 后台巡检查单 ====================