new-api/.plans/alipay-payment/backend-dev/task-alipay-backend/task_plan.md

支付宝后端 - 任务计划

所属智能体: backend-dev 状态: pending 创建: 2026-04-14

目标

实现支付宝当面付（扫码支付）的完整后端功能，包括配置层、控制器、模型和路由。

详细步骤

• 1. 新建 setting/payment_alipay.go：配置变量 + IsAlipayConfigured() + OnAlipayConfigChanged
• 2. 修改 model/option.go：InitOptionMap + updateOptionMap + triggerAlipayReset
• 3. 新建 model/topup_alipay.go：RechargeAlipay 函数（事务+行锁+幂等）
• 4. 新建 controller/topup_alipay.go：客户端缓存 + 5 个 HTTP 处理函数
• 5. 修改 controller/topup.go：GetTopUpInfo 添加支付宝支付方式
• 6. 修改 model/topup.go：ManualCompleteTopUp 添加 “alipay”
• 7. 修改 router/api-router.go：注册 4 个路由
• 8. go build 编译验证

涉及文件

• setting/payment_alipay.go — 新建：支付宝配置
• setting/payment_wechat.go — 参考：微信支付配置模式
• controller/topup_alipay.go — 新建：支付宝控制器
• controller/topup_wechat.go — 参考：微信支付控制器
• model/topup_alipay.go — 新建：支付宝充值模型
• model/topup_wechat.go — 参考：微信充值模型
• model/option.go — 修改：注册配置 key
• model/topup.go — 修改：添加 alipay 支付方式
• controller/topup.go — 修改：GetTopUpInfo
• router/api-router.go — 修改：注册路由

关键技术点

• gopay alipay 子包：github.com/go-pay/gopay/alipay
• TradePrecreate API：当面付预下单
• 金额单位：元（字符串 “7.00”），不是微信的分
• 回调验签：alipay.VerifySign(alipayPublicKey, notifyReq)
• 回调响应：纯文本 “success”
• 订单号前缀：ali（区分微信的 wx）

依赖

• 无外部依赖，go-pay 已在项目中