Skip to content

fix(payment): bound closed-order payment recovery by the order deadline - #8765

Open
lishuangqiang wants to merge 1 commit into
Wei-Shaw:mainfrom
lishuangqiang:fix/payment-closed-order-recovery-window
Open

lishuangqiang wants to merge 1 commit into
Wei-Shaw:mainfrom
lishuangqiang:fix/payment-closed-order-recovery-window

Conversation

@lishuangqiang

@lishuangqiang lishuangqiang commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

问题

支付订单在 expires_at 之后被标记为 EXPIRED,或者被用户/管理员取消为 CANCELLED。这两种状态下上游仍可能确认收到钱,所以需要允许“恢复入账”;但 toPaid 的判定条件本身不成立:

paymentorder.StatusEQ(OrderStatusCancelled),              // 无任何时间约束
paymentorder.And(
    paymentorder.StatusEQ(OrderStatusExpired),
    paymentorder.UpdatedAtGTE(now.Add(-5 * time.Minute)), // 用 updated_at 当“关闭时刻”
),

updated_at 不是“关闭时刻”,任何写入都会刷新它。

触发场景

  1. 订单几小时前就过期(updated_at = 当时);
  2. 用户调用 VerifyOrderByOutTradeNo(或带签名的 resume-token 查单);
  3. checkPaidWithOptions 在上游返回已支付后,先把 upstram trade_no 落库——
    paymentorderShouldPersistUpstreamTradeNo 在 payment_trade_no 为空或与上游不同时返回 true,
    这是扫码 / precreate 单的常态,于是这次 UPDATE 把 updated_at 刷成了当下;
  4. 紧接着 HandlePaymentNotification → confirmPayment 重新读库,updated_at 已经是现在,
    5 分钟宽限成立 → 订单置为 PAID 并履约。

履约金额取自订单快照(amount / bonus_amount / pay_amount 都在下单时锁定),所以效果是
一张早已关闭的订单被按旧价格复活:充值倍率、赠送档位、套餐价格在下单后调整过,也会按旧值到账。

CANCELLED 更直接:没有任何时间约束,任何时刻的迟到支付都按旧快照入账(渠道侧关闭失败、
或用户在多端同时操作时并不罕见)。

修复

  • 过期与取消统一用订单自身的 expires_at + paymentRecoveryWindow(30 分钟) 判定,
    与 updated_at 解耦,内部写入无法再延长恢复窗口;
  • 超出窗口的支付不再自动履约,改为写 PAYMENT_AFTER_EXPIRY / PAYMENT_AFTER_CANCEL
    审计(含 expiresAt / recoveryEnd / updatedAt)并向渠道 ack,转人工处理,
    避免渠道无限重试;
  • 窗口内的支付行为不变:到期瞬间付款、回调稍晚到达(含过期任务执行间隔带来的延迟)仍正常入账。

paymentRecoveryWindow 是一个具名常量,维护者可以按部署实际的渠道回调延迟调整。

测试

新增 payment_order_recovery_window_test.go,四种组合:

用例 场景 期望
TestVerifyOrderByOutTradeNoDoesNotReviveOrderLongAfterExpiry 过期 3h,查单回填 trade_no 不履约,PAYMENT_AFTER_EXPIRY
TestWebhookPaymentForLongCancelledOrderIsNotFulfilled 取消 3h,回调到达 不履约,ack + PAYMENT_AFTER_CANCEL
TestExpiredOrderPaidWithinRecoveryWindowIsFulfilled 过期 1min 正常入账
TestCancelledOrderPaidWithinOrderWindowIsRecovered 取消后仍在有效期内支付 正常入账

前两条在修复前失败(订单被置为 COMPLETED、余额按旧金额到账),修复后通过;后两条在修复前后都通过,用于锁定“不要误杀正常恢复”。

本地验证:

  • go test -tags=unit ./internal/service/ ./internal/handler/ ./internal/repository/
    (internal/service 全量跑时有一条与本改动无关的堆内存断言偶发失败
    TestInflightEstimate_AccountMappingNoDBAndBoundedMemory,单独运行通过)
  • go vet -tags=unit ./internal/service/ 通过

需要确认的行为变化

超出窗口的迟到支付从“自动入账”改为“只记审计、转人工”。这是刻意的:自动入账等于允许无限期的旧价格履约。如果维护者希望更长/更短的窗口,只需调整 paymentRecoveryWindow。

后续可做的根因治理(本 PR 未包含):把订单 expires_at 传给渠道侧(支付宝 timeout_express、微信 time_expire、Stripe Checkout expires_at),让支付会话随订单一起失效,从源头上减少“过期后仍能付款”的情况。


Closes #8766

EXPIRED/CANCELLED 订单仍可能收到上游支付确认,过去是这样收敛的:

- EXPIRED:要求 updated_at 在最近 5 分钟内;
- CANCELLED:无任何时间约束。

updated_at 不是“关闭时刻”,它是可被任何写入刷新的字段。主动查单
(VerifyOrderByOutTradeNo / resume-token 查单) 在调用 HandlePaymentNotification
之前会先把上游 trade_no 落库,这次 UPDATE 把 updated_at 刷新为当下,于是:

1. 几小时前就过期的订单,用户点一次“查询支付状态”;
2. 上游返回已支付,且 trade_no 与库里不同(扫码/precreate 单的常态);
3. 宽限判断成立,订单被置为 PAID 并按**下单时锁定的金额**履约。

CANCELLED 更直接:没有时间约束,任何时刻的迟到支付都按旧快照入账。

修复:

- 过期与取消统一用订单自身的 expires_at + paymentRecoveryWindow(30m) 判定,
  与 updated_at 解耦,内部写入无法再延长恢复窗口;
- 超出窗口的支付不再自动履约,改为落 PAYMENT_AFTER_EXPIRY / PAYMENT_AFTER_CANCEL
  审计(含 expiresAt / recoveryEnd)并 ack,转人工处理,避免渠道无限重试;
- 窗口内的支付保持原行为:到期瞬间付款、回调稍晚到达仍正常入账。

测试:新增 payment_order_recovery_window_test.go 四个用例,覆盖“过期/取消”
在窗口内外的四种组合;窗口外的两条在修复前失败(订单被履约、余额按旧金额到账)。
@lishuangqiang

Copy link
Copy Markdown
Contributor Author

CI 情况说明:backend-security 的失败与本案改动无关。

govulncheck 报的是标准库漏洞 GO-2026-6859(net/http@go1.27.3,fixed in go1.27.4),仓库当前固定在 Go 1.27.3。同一失败也出现在 #8667 等其它 PR 上,main 最后一次安全扫描成功是 11-11 的 530c5e3a。

已单独提交 #8767 升级工具链(go.mod + 4 处 workflow 断言 + 3 个 Dockerfile)。那个 PR 合入后本 PR 重新跑即可转绿。

本 PR 自身的检查:test(单测 + 集成)、golangci-lint、frontend、shell、cla-check 均已通过。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] 过期/取消订单可被查单复活,按旧价格快照履约

1 participant