liujie
2026-09-17 819124be8f16794d409a67f58d5257aef37d9b64
backend/src/main/java/com/tourguide/common/huifu/README.md
@@ -19,9 +19,9 @@
## 3. 回调验签
目的:确保支付、退款、提现回调确实来自斗拱平台,防止伪造回调修改本地订单或资金状态。  
操作:`DouGongNotifyController` 接收 `/base/dougong/**`,校验 `sign` 和 `resp_data`,使用 `HUIFU_RSA_PUBLIC_KEY` 验签;支付回调继续校验商户号、支付金额和交易状态。
影响范围:影响 `/base/dougong/pay-notify`、`/base/dougong/refund-logistics`、`/base/dougong/refund-crosscity`、`/base/dougong/encashment`。
验证:安全配置已放行 `/base/dougong/**`;回调成功时日志会记录 `req_seq_id`、`org_req_seq_id`、`trans_stat`。
操作:`DouGongNotifyController` 接收 `/base/dougong/**` 和 `/api/base/dougong/**`,回调路径免 Token,校验 `sign` 和 `resp_data`,使用 `HUIFU_RSA_PUBLIC_KEY` 验签;支付回调继续校验商户号、支付金额和交易状态。
影响范围:影响 `/base/dougong/pay-notify`、`/api/base/dougong/pay-notify` 以及对应的退款、提现回调路径。
验证:安全配置已放行 `/base/dougong/**` 和 `/api/base/dougong/**`;回调成功时日志会记录 `req_seq_id`、`org_req_seq_id`、`trans_stat`。
注意:只有 `trans_stat=S` 的验签成功回调才会把订单从 `PENDING_PAYMENT` 更新为 `PENDING_ACCEPT`;重复回调不会重复派单,金额不一致或商户号不匹配返回 `FAIL`。
## 4. 退款处理