package service import ( "context" "fmt" "log/slog" "strconv" "time" dbent "github.com/Wei-Shaw/sub2api/ent" "github.com/Wei-Shaw/sub2api/ent/paymentauditlog" "github.com/Wei-Shaw/sub2api/ent/paymentorder" "github.com/Wei-Shaw/sub2api/internal/payment" "github.com/Wei-Shaw/sub2api/internal/payment/provider" infraerrors "github.com/Wei-Shaw/sub2api/internal/pkg/errors" ) // --- Cancel & Expire --- // Cancel rate limit configuration constants. const ( rateLimitUnitDay = "day" rateLimitUnitMinute = "minute" rateLimitUnitHour = "hour" rateLimitModeFixed = "fixed" checkPaidResultAlreadyPaid = "already_paid" checkPaidResultCancelled = "cancelled" ) func (s *PaymentService) checkCancelRateLimit(ctx context.Context, userID int64, cfg *PaymentConfig) error { if !cfg.CancelRateLimitEnabled || cfg.CancelRateLimitMax <= 0 { return nil } windowStart := cancelRateLimitWindowStart(cfg) operator := fmt.Sprintf("user:%d", userID) count, err := s.entClient.PaymentAuditLog.Query(). Where( paymentauditlog.ActionEQ("ORDER_CANCELLED"), paymentauditlog.OperatorEQ(operator), paymentauditlog.CreatedAtGTE(windowStart), ).Count(ctx) if err != nil { slog.Error("check cancel rate limit failed", "userID", userID, "error", err) return nil // fail open } if count >= cfg.CancelRateLimitMax { return infraerrors.TooManyRequests("CANCEL_RATE_LIMITED", "cancel rate limited"). WithMetadata(map[string]string{ "max": strconv.Itoa(cfg.CancelRateLimitMax), "window": strconv.Itoa(cfg.CancelRateLimitWindow), "unit": cfg.CancelRateLimitUnit, }) } return nil } func cancelRateLimitWindowStart(cfg *PaymentConfig) time.Time { now := time.Now() w := cfg.CancelRateLimitWindow if w <= 0 { w = 1 } unit := cfg.CancelRateLimitUnit if unit == "" { unit = rateLimitUnitDay } if cfg.CancelRateLimitMode == rateLimitModeFixed { switch unit { case rateLimitUnitMinute: t := now.Truncate(time.Minute) return t.Add(-time.Duration(w-1) * time.Minute) case rateLimitUnitDay: y, m, d := now.Date() t := time.Date(y, m, d, 0, 0, 0, 0, now.Location()) return t.AddDate(0, 0, -(w - 1)) default: // hour t := now.Truncate(time.Hour) return t.Add(-time.Duration(w-1) * time.Hour) } } // rolling window switch unit { case rateLimitUnitMinute: return now.Add(-time.Duration(w) * time.Minute) case rateLimitUnitDay: return now.AddDate(0, 0, -w) default: // hour return now.Add(-time.Duration(w) * time.Hour) } } func (s *PaymentService) CancelOrder(ctx context.Context, orderID, userID int64) (string, error) { o, err := s.entClient.PaymentOrder.Get(ctx, orderID) if err != nil { return "", infraerrors.NotFound("NOT_FOUND", "order not found") } if o.UserID != userID { return "", infraerrors.Forbidden("FORBIDDEN", "no permission for this order") } if o.Status != OrderStatusPending { return "", infraerrors.BadRequest("INVALID_STATUS", "order cannot be cancelled in current status") } return s.cancelCore(ctx, o, OrderStatusCancelled, fmt.Sprintf("user:%d", userID), "user cancelled order") } func (s *PaymentService) AdminCancelOrder(ctx context.Context, orderID int64) (string, error) { o, err := s.entClient.PaymentOrder.Get(ctx, orderID) if err != nil { return "", infraerrors.NotFound("NOT_FOUND", "order not found") } if o.Status != OrderStatusPending { return "", infraerrors.BadRequest("INVALID_STATUS", "order cannot be cancelled in current status") } return s.cancelCore(ctx, o, OrderStatusCancelled, "admin", "admin cancelled order") } func (s *PaymentService) cancelCore(ctx context.Context, o *dbent.PaymentOrder, fs, op, ad string) (string, error) { if o.PaymentTradeNo != "" || o.PaymentType != "" { if s.checkPaid(ctx, o) == checkPaidResultAlreadyPaid { return checkPaidResultAlreadyPaid, nil } } c, err := s.entClient.PaymentOrder.Update().Where(paymentorder.IDEQ(o.ID), paymentorder.StatusEQ(OrderStatusPending)).SetStatus(fs).Save(ctx) if err != nil { return "", fmt.Errorf("update order status: %w", err) } if c > 0 { auditAction := "ORDER_CANCELLED" if fs == OrderStatusExpired { auditAction = "ORDER_EXPIRED" } s.writeAuditLog(ctx, o.ID, auditAction, op, map[string]any{"detail": ad}) } return checkPaidResultCancelled, nil } func (s *PaymentService) checkPaid(ctx context.Context, o *dbent.PaymentOrder) string { prov, err := s.getOrderProvider(ctx, o) if err != nil { return "" } // Use OutTradeNo as fallback when PaymentTradeNo is empty // (e.g. EasyPay popup mode where trade_no arrives only via notify callback) tradeNo := o.PaymentTradeNo if tradeNo == "" { tradeNo = o.OutTradeNo } resp, err := prov.QueryOrder(ctx, tradeNo) if err != nil { slog.Warn("query upstream failed", "orderID", o.ID, "error", err) return "" } if resp.Status == payment.ProviderStatusPaid { if err := s.HandlePaymentNotification(ctx, &payment.PaymentNotification{TradeNo: o.PaymentTradeNo, OrderID: o.OutTradeNo, Amount: resp.Amount, Status: payment.ProviderStatusSuccess}, prov.ProviderKey()); err != nil { slog.Error("fulfillment failed during checkPaid", "orderID", o.ID, "error", err) // Still return already_paid — order was paid, fulfillment can be retried } return checkPaidResultAlreadyPaid } if cp, ok := prov.(payment.CancelableProvider); ok { _ = cp.CancelPayment(ctx, tradeNo) } return "" } // VerifyOrderByOutTradeNo actively queries the upstream provider to check // if a payment was made, and processes it if so. This handles the case where // the provider's notify callback was missed (e.g. EasyPay popup mode). func (s *PaymentService) VerifyOrderByOutTradeNo(ctx context.Context, outTradeNo string, userID int64) (*dbent.PaymentOrder, error) { o, err := s.entClient.PaymentOrder.Query(). Where(paymentorder.OutTradeNo(outTradeNo)). Only(ctx) if err != nil { return nil, infraerrors.NotFound("NOT_FOUND", "order not found") } if o.UserID != userID { return nil, infraerrors.Forbidden("FORBIDDEN", "no permission for this order") } // Only verify orders that are still pending or recently expired if o.Status == OrderStatusPending || o.Status == OrderStatusExpired { result := s.checkPaid(ctx, o) if result == checkPaidResultAlreadyPaid { // Reload order to get updated status o, err = s.entClient.PaymentOrder.Get(ctx, o.ID) if err != nil { return nil, fmt.Errorf("reload order: %w", err) } } } return o, nil } // VerifyOrderPublic verifies payment status without user authentication. // Used by the payment result page when the user's session has expired. func (s *PaymentService) VerifyOrderPublic(ctx context.Context, outTradeNo string) (*dbent.PaymentOrder, error) { o, err := s.entClient.PaymentOrder.Query(). Where(paymentorder.OutTradeNo(outTradeNo)). Only(ctx) if err != nil { return nil, infraerrors.NotFound("NOT_FOUND", "order not found") } if o.Status == OrderStatusPending || o.Status == OrderStatusExpired { result := s.checkPaid(ctx, o) if result == checkPaidResultAlreadyPaid { o, err = s.entClient.PaymentOrder.Get(ctx, o.ID) if err != nil { return nil, fmt.Errorf("reload order: %w", err) } } } return o, nil } func (s *PaymentService) ExpireTimedOutOrders(ctx context.Context) (int, error) { now := time.Now() orders, err := s.entClient.PaymentOrder.Query().Where(paymentorder.StatusEQ(OrderStatusPending), paymentorder.ExpiresAtLTE(now)).All(ctx) if err != nil { return 0, fmt.Errorf("query expired: %w", err) } n := 0 for _, o := range orders { // Check upstream payment status before expiring — the user may have // paid just before timeout and the webhook hasn't arrived yet. outcome, _ := s.cancelCore(ctx, o, OrderStatusExpired, "system", "order expired") if outcome == checkPaidResultAlreadyPaid { slog.Info("order was paid during expiry", "orderID", o.ID) continue } if outcome != "" { n++ } } return n, nil } // getOrderProvider creates a provider using the order's original instance config. // Falls back to registry lookup if instance ID is missing (legacy orders). func (s *PaymentService) getOrderProvider(ctx context.Context, o *dbent.PaymentOrder) (payment.Provider, error) { if o.ProviderInstanceID != nil && *o.ProviderInstanceID != "" { instID, err := strconv.ParseInt(*o.ProviderInstanceID, 10, 64) if err == nil { cfg, err := s.loadBalancer.GetInstanceConfig(ctx, instID) if err == nil { providerKey := s.registry.GetProviderKey(o.PaymentType) if providerKey == "" { providerKey = o.PaymentType } p, err := provider.CreateProvider(providerKey, *o.ProviderInstanceID, cfg) if err == nil { return p, nil } } } } s.EnsureProviders(ctx) return s.registry.GetProvider(o.PaymentType) }