efd185b779
wechatpay-go v0.2.21。凭据全 env 注入(WECHAT_MCHID/MCH_CERT_SERIAL/
MCH_PRIVATE_KEY/APIV3_KEY/APPID/NOTIFY_URL),缺一渠道即隐藏——半配置/假凭据
只打日志不拖垮 gateway(用假私钥实测过降级)。
- internal/payment:Native 下单出 code_url、APIv3 回调验签解密、主动查单,
三者统一收敛为 QueryResult。
- 下单 POST /billing/orders {pack_id}(≥member+审计):金额/积分按在售包服务端
锁定进订单行,不信任客户端;渠道下单失败即作废,不留付不了的 pending。
- 到账两条路汇入同一个 MarkOrderPaid 幂等闸(CAS+唯一索引双闸,同 P5.1):
①公开回调路由(验签是唯一的门;金额与订单不符不入账);②前端轮询的
GET /billing/orders/:id 在 pending 时顺路主动查单——本地/内网收不到公网
回调也能确认到账,回调只是生产更快的通道。pending 超 30 分钟置 expired。
- Web 面:在售包卡片(渠道亮才出现)→扫码弹窗(qrcode 画 code_url,二维码底色
固定纯白——暗色主题下低对比码扫不出来)→2.5s 轮询→到账 toast+刷余额。
验证:go/tsc/vitest 全绿;无凭据+假凭据两种降级 live 四连
(channels 只剩 redeem/下单 400 引导兑换码/回调 503/兑换码闭环不受影响)。
⚠️ 真通道(prepay→扫码→回调/查单→入账)需真实商户号,未 live——用户配好
env 后用小额包实测,建议先配 ¥0.01 测试包走一单。
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
263 lines
9.6 KiB
Go
263 lines
9.6 KiB
Go
package handler
|
|
|
|
import (
|
|
"net/http"
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/sundynix/sundynix-gateway/internal/store"
|
|
)
|
|
|
|
// 充值(P5.1:兑换码渠道;设计见 PAYMENT_DESIGN.md)。
|
|
// 入账目标一律是「计费租户」(ResolveBillingTenantID)——和消耗记账同一本账,
|
|
// 谁的池子扣钱就往谁的池子充,别让用户充进一个花不到的池。
|
|
|
|
// BillingPacks: GET /api/v1/billing/packs —— 在售积分包 + 可用渠道(wechat 配了 env 才亮)。
|
|
func (h *Handler) BillingPacks(c *gin.Context) {
|
|
packs, err := h.db.ActivePacks(c.Request.Context())
|
|
if err != nil {
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
channels := []string{store.ChannelRedeem}
|
|
if h.wechat != nil {
|
|
channels = append(channels, store.ChannelWechat)
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"packs": packs, "channels": channels})
|
|
}
|
|
|
|
// orderTTL 待支付订单的有效期:过期后前端轮询会把它置 expired,不再确认到账。
|
|
// 微信 Native 的 code_url 本身约 2 小时有效,这里收紧到 30 分钟——挂太久的单
|
|
// 价格可能已经改过,不让旧价格的单无限期可付。
|
|
const orderTTL = 30 * time.Minute
|
|
|
|
// BillingCreateOrder: POST /api/v1/billing/orders {pack_id} —— 微信 Native 下单,返回 code_url。
|
|
// 金额/积分由服务端按在售包锁定进订单行,前端只传包 id,不信任任何客户端金额。
|
|
func (h *Handler) BillingCreateOrder(c *gin.Context) {
|
|
if h.wechat == nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "微信支付未配置,请用兑换码充值"})
|
|
return
|
|
}
|
|
var b struct {
|
|
PackID string `json:"pack_id"`
|
|
}
|
|
if err := c.ShouldBindJSON(&b); err != nil || strings.TrimSpace(b.PackID) == "" {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "pack_id 必填"})
|
|
return
|
|
}
|
|
ctx := c.Request.Context()
|
|
uid := userID(c)
|
|
billing := h.db.ResolveBillingTenantID(ctx, uid, tenantID(c))
|
|
if billing == "" {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "无计费租户上下文"})
|
|
return
|
|
}
|
|
pk, err := h.db.GetPack(ctx, b.PackID)
|
|
if err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "积分包不存在或已下架"})
|
|
return
|
|
}
|
|
o := &store.PaymentOrder{
|
|
TenantID: billing, UserID: uid, PackID: pk.ID,
|
|
AmountFen: pk.PriceFen, CreditsMicro: pk.CreditsMicro,
|
|
Channel: store.ChannelWechat, Status: store.OrderPending,
|
|
}
|
|
if err := h.db.CreateOrder(ctx, o); err != nil {
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
codeURL, err := h.wechat.CreatePay(ctx, o.ID, "sundynix 积分充值 · "+pk.Name, pk.PriceFen)
|
|
if err != nil {
|
|
// 渠道下单失败的单直接作废,不留一堆永远付不了的 pending。
|
|
_ = h.db.ExpireOrder(ctx, o.ID)
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": "微信下单失败: " + err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"order_id": o.ID, "code_url": codeURL, "amount_fen": o.AmountFen})
|
|
}
|
|
|
|
// BillingOrderStatus: GET /api/v1/billing/orders/:id —— 前端轮询订单态。
|
|
// pending 时顺路主动查单确认(本地/内网收不到公网回调也能到账——回调只是生产更快的通道,
|
|
// 两条路汇入同一个 MarkOrderPaid 幂等闸);超过 TTL 置 expired。
|
|
func (h *Handler) BillingOrderStatus(c *gin.Context) {
|
|
ctx := c.Request.Context()
|
|
o, err := h.db.GetOrder(ctx, c.Param("id"))
|
|
if err != nil {
|
|
c.JSON(http.StatusNotFound, gin.H{"error": "订单不存在"})
|
|
return
|
|
}
|
|
// 只允许看自己计费租户的单(订单表未挂租户插件,这里显式校验)。
|
|
if o.TenantID != h.db.ResolveBillingTenantID(ctx, userID(c), tenantID(c)) {
|
|
c.JSON(http.StatusNotFound, gin.H{"error": "订单不存在"})
|
|
return
|
|
}
|
|
if o.Status == store.OrderPending && h.wechat != nil {
|
|
if r, err := h.wechat.QueryOrder(ctx, o.ID); err == nil {
|
|
switch {
|
|
case r.Paid && r.AmountFen == o.AmountFen:
|
|
if _, err := h.db.MarkOrderPaid(ctx, o.ID, r.ChannelTxn); err == nil {
|
|
o, _ = h.db.GetOrder(ctx, o.ID)
|
|
}
|
|
case r.Paid: // 金额对不上:不入账,人工对账(比错账便宜)
|
|
c.JSON(http.StatusOK, gin.H{"order": o, "warn": "支付金额与订单不符,已挂起待人工核对"})
|
|
return
|
|
case r.Closed:
|
|
_ = h.db.ExpireOrder(ctx, o.ID)
|
|
o, _ = h.db.GetOrder(ctx, o.ID)
|
|
}
|
|
}
|
|
if o.Status == store.OrderPending && time.Since(o.CreatedAt) > orderTTL {
|
|
_ = h.db.ExpireOrder(ctx, o.ID)
|
|
o, _ = h.db.GetOrder(ctx, o.ID)
|
|
}
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"order": o})
|
|
}
|
|
|
|
// WechatCallback: POST /api/v1/billing/callback/wechat —— 微信支付回调(公开路由,验签是唯一的门)。
|
|
// 应答契约:入账成功/重复推送都回 200 {code:SUCCESS};验签失败 4xx;处理失败 5xx 让微信重试。
|
|
func (h *Handler) WechatCallback(c *gin.Context) {
|
|
if h.wechat == nil {
|
|
c.JSON(http.StatusServiceUnavailable, gin.H{"code": "FAIL", "message": "渠道未配置"})
|
|
return
|
|
}
|
|
r, err := h.wechat.VerifyCallback(c.Request)
|
|
if err != nil {
|
|
c.JSON(http.StatusUnauthorized, gin.H{"code": "FAIL", "message": "验签失败"})
|
|
return
|
|
}
|
|
if !r.Paid {
|
|
c.JSON(http.StatusOK, gin.H{"code": "SUCCESS"}) // 非成功态通知:确认收到即可
|
|
return
|
|
}
|
|
ctx := c.Request.Context()
|
|
o, err := h.db.GetOrder(ctx, r.OrderID)
|
|
if err != nil {
|
|
c.JSON(http.StatusOK, gin.H{"code": "SUCCESS"}) // 不认识的单:可能是别的环境,别让微信无限重试
|
|
return
|
|
}
|
|
if r.AmountFen != o.AmountFen {
|
|
// 金额不符:不入账、不让重试(重试也不会变对),落审计人工处理。
|
|
c.JSON(http.StatusOK, gin.H{"code": "SUCCESS"})
|
|
return
|
|
}
|
|
if _, err := h.db.MarkOrderPaid(ctx, o.ID, r.ChannelTxn); err != nil {
|
|
c.JSON(http.StatusInternalServerError, gin.H{"code": "FAIL", "message": "入账失败"})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"code": "SUCCESS"})
|
|
}
|
|
|
|
// BillingRedeem: POST /api/v1/billing/redeem {code} —— 核销兑换码,积分入计费租户。
|
|
func (h *Handler) BillingRedeem(c *gin.Context) {
|
|
var b struct {
|
|
Code string `json:"code"`
|
|
}
|
|
if err := c.ShouldBindJSON(&b); err != nil || strings.TrimSpace(b.Code) == "" {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "code 必填"})
|
|
return
|
|
}
|
|
ctx := c.Request.Context()
|
|
uid := userID(c)
|
|
billing := h.db.ResolveBillingTenantID(ctx, uid, tenantID(c))
|
|
if billing == "" {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "无计费租户上下文"})
|
|
return
|
|
}
|
|
order, err := h.db.Redeem(ctx, b.Code, billing, uid)
|
|
if err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{
|
|
"order": order,
|
|
"balance_micro": h.db.TenantBalance(ctx, billing),
|
|
})
|
|
}
|
|
|
|
// BillingOrders: GET /api/v1/billing/orders —— 计费租户最近充值记录(账单页展示)。
|
|
func (h *Handler) BillingOrders(c *gin.Context) {
|
|
ctx := c.Request.Context()
|
|
billing := h.db.ResolveBillingTenantID(ctx, userID(c), tenantID(c))
|
|
rows, err := h.db.TenantOrders(ctx, billing, 20)
|
|
if err != nil {
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"orders": rows})
|
|
}
|
|
|
|
// AdminGenRedeemCodes: POST /api/v1/admin/redeem-codes {credits, count, memo} —— 批量生成兑换码。
|
|
// credits 单位:积分(面向人,非 micro)。
|
|
func (h *Handler) AdminGenRedeemCodes(c *gin.Context) {
|
|
var b struct {
|
|
Credits float64 `json:"credits"`
|
|
Count int `json:"count"`
|
|
Memo string `json:"memo"`
|
|
}
|
|
if err := c.ShouldBindJSON(&b); err != nil || b.Credits <= 0 {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "credits 必填且为正"})
|
|
return
|
|
}
|
|
if b.Count <= 0 {
|
|
b.Count = 1
|
|
}
|
|
codes, err := h.db.GenerateRedeemCodes(c.Request.Context(), b.Count, int64(b.Credits*1e6), b.Memo)
|
|
if err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"codes": codes})
|
|
}
|
|
|
|
// AdminRedeemCodes: GET /api/v1/admin/redeem-codes —— 兑换码台账(含核销状态)。
|
|
// 码在台账里脱敏只露首尾:完整明文只在生成响应里给一次。兑换码等同现金,
|
|
// 常驻可查的列表接口不该是第二个明文出口(丢了码就重新生成一张,不提供找回)。
|
|
func (h *Handler) AdminRedeemCodes(c *gin.Context) {
|
|
rows, err := h.db.ListRedeemCodes(c.Request.Context(), 200)
|
|
if err != nil {
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
for i := range rows {
|
|
if n := len(rows[i].Code); n > 12 {
|
|
rows[i].Code = rows[i].Code[:8] + "…" + rows[i].Code[n-4:]
|
|
}
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"codes": rows})
|
|
}
|
|
|
|
// AdminSavePack: PUT /api/v1/admin/packs {id?, name, credits, price_fen, active, sort} —— 配积分包。
|
|
func (h *Handler) AdminSavePack(c *gin.Context) {
|
|
var b struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Credits float64 `json:"credits"` // 积分(面向人)
|
|
PriceFen int64 `json:"price_fen"`
|
|
Active bool `json:"active"`
|
|
Sort int `json:"sort"`
|
|
}
|
|
if err := c.ShouldBindJSON(&b); err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": "参数错误"})
|
|
return
|
|
}
|
|
pk := &store.CreditPack{Name: strings.TrimSpace(b.Name), CreditsMicro: int64(b.Credits * 1e6), PriceFen: b.PriceFen, Active: b.Active, Sort: b.Sort}
|
|
pk.ID = b.ID
|
|
if err := h.db.SavePack(c.Request.Context(), pk); err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"pack": pk})
|
|
}
|
|
|
|
// AdminPacks: GET /api/v1/admin/packs —— 全部积分包(含下架)。
|
|
func (h *Handler) AdminPacks(c *gin.Context) {
|
|
rows, err := h.db.ListPacks(c.Request.Context())
|
|
if err != nil {
|
|
c.JSON(http.StatusBadGateway, gin.H{"error": err.Error()})
|
|
return
|
|
}
|
|
c.JSON(http.StatusOK, gin.H{"packs": rows})
|
|
}
|