如何从多笔已授权Paypal交易中仅CAPTURE对应同一orderId的一笔？

1 底层数据库幂等约束（必做） #

• 给交易记录表新增**order_id + success_captured**联合唯一索引，其中success_captured是布尔字段，仅当交易完成CAPTURE时设为1，其余状态均为0，从数据库层面保证同一个orderId永远只能存在1条CAPTURE成功的记录，重复插入会直接触发唯一键冲突，从底层杜绝多笔成功请款的可能。
• 强制交易状态机单向流转：仅允许PENDING_PAYMENT → AUTHORIZED → CAPTURED / REFUNDED的流转路径，禁止反向、跳步操作。收到Paypal的AUTHORIZED回调时，先查询对应orderId下是否已经存在CAPTURED状态的记录，若已存在，直接对当前回调对应的Paypal交易执行退款，不触发CAPTURE操作。

2 并发场景锁优化（高并发场景推荐） #

• 收到Paypal webhook回调时，首先以pay_capture_lock:{orderId}为key加分布式排他锁，锁超时时间设置为30s即可（大于CAPTURE+退款接口的最大调用耗时），同一时间仅允许1个针对同orderId的回调请求拿到锁执行后续逻辑。
• 拿到锁后执行如下原子操作：
  • 二次校验orderId的全局状态，若已存在CAPTURE成功的记录，直接触发当前交易的退款，释放锁
  • 若不存在成功CAPTURE的记录，执行当前交易的CAPTURE操作，操作成功后更新orderId对应全局状态为已完成，释放锁；若CAPTURE操作失败，直接释放锁即可，后续其他回调请求可自动重试
• 所有状态更新操作加数据库乐观锁校验，示例更新语句：

UPDATE trade SET status = 'CAPTURED' WHERE order_id = '目标orderId' AND status = 'AUTHORIZED'

通过判断执行后影响行数是否为1，避免并发更新导致的状态异常。

3 兜底校验逻辑 #

• 新增定时扫描任务，每小时校验最近24小时内的交易数据，若发现同一个orderId下存在多笔非退款状态的交易，除最早完成CAPTURE的交易外，其余全部自动触发退款操作，覆盖极端并发场景下的漏判情况。
• 退款完成后可触发用户通知，告知重复支付金额已原路退回，提升用户体验。

内容的提问来源于stack exchange，提问作者typicallearner