1398281322-a11y/java-backend-guardrails / skills/java-backend-guardrails/pay-duplicate
pay-duplicate
VerifiedUse when handling 重复支付, 同一订单两笔成功, 支付与超时关单撞车, 用户连点收银台, or rows=0 after pay update. Do not auto-refund without reading current status.
重复支付 / 关单撞车
When to Invoke
用户点两次支付、微信+余额同时付、支付回调与 30 分钟关单并发、条件更新影响行数 0。支付面试里最容易答错的并发题。
When NOT
普通重复回调(已 SUCCESS 再来)→ pay-notify 幂等返回即可。渠道退款怎么调 → pay-refund-channel。
风险(面试考点)
- 连点:两次 unified order,两个 QR,用户付两次。
- 关单撞车:29:59 付款,30:00 关单。关单赢了钱还在。
- rows=0 就退款:第二次回调 rows=0 可能是重复成功,不是失败。误退会把第一笔也冲掉或平白出账。
一笔业务订单应对一笔 进行中 支付单。新支付前关掉/作废旧的 PAYING(调渠道 close,失败则查单)。
方案选型(轻量优先)
| 现象 | 处理 |
|---|---|
| 重复回调,已 SUCCESS | 返回成功,不退款 |
| 订单已 PAID,又来一笔不同 transaction_id 成功 | 多付:记差错,对多余一笔原路退,主单保持 PAID |
| 订单已 CLOSED,钱后到 | 迟到款:禁止改回 PAID 覆盖关单;入差错,退款或捞回(产品定) |
| 关单 UPDATE CREATED→CLOSED 与支付抢行 | 谁更新成功谁赢;输的一方二次查状态再决策 |
默认建议:钱到了优先 认款(捞回订单)还是 退款 由产品定。代码必须分出这两种,禁止 rows=0 无脑退。
默认方案
int rows = orderMapper.markPaid(orderNo, "CREATED");
if (rows == 1) return;
Order o = orderMapper.selectByNo(orderNo);
switch (o.getStatus()) {
case "PAID" -> { /* 重复回调 */ }
case "CLOSED" -> reconMapper.insertLatePay(orderNo, txnId); // 差错,异步退或捞回
default -> log.error("支付回调碰到非法状态 {}", o.getStatus());
}
同一 order_no 只允许一条 PAYING 支付单(部分唯一索引或应用关旧开新)。
-- 支付单:同一订单可有多条历史,但成功入账要对账
uk (channel, out_trade_no)
-- 成功渠道交易号全局唯一
uk (channel, transaction_id)
反例
错误:if (rows==0) refund()。
正确:先查当前状态。
错误:收银台每次点都新 out_trade_no,旧 QR 仍能付。 正确:关旧单或同号覆盖(渠道允许时)。
错误:已退款后又把迟到的支付成功改成 PAID。 正确:REFUNDED 不能倒回,进差错。
验证
- 两笔不同 transaction_id 成功,只履约一次,多余一笔进入退款且只退一次。
- 关单与回调对打,最终要么 PAID+履约,要么 CLOSED+退款,不出现 CLOSED 且钱留下无记录。
- 重复回调不触发退款。
评审清单
- 同时只有一笔 PAYING
- rows=0 有状态分支
- 多付/迟到款有差错单
- 已退款不能被成功回调改回去
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |