Inspiration

In today's digital economy, subscriptions have become the default billing model for software, streaming, productivity tools, and cloud services. However, this convenience comes at a steep price: subscription fatigue and hidden cash leaks. Individuals and small businesses routinely lose hundreds to thousands of dollars every year to:

  • Zombie Subscriptions: Forgotten tools with low or zero utilization that silently auto-renew month after month.
  • Redundant SaaS Overlaps: Paying for multiple services that serve identical functional scopes (e.g., maintaining active subscriptions for both ChatGPT Plus and Claude Pro, or multiple vector design tools).
  • Silent Price Creep: Unannounced price increases on existing subscriptions that erode monthly operating budgets.
  • Global Currency Distortions: Cross-border software services billing in mismatched currencies without real-time transparency into exchange rates or regional tier equivalents.

We built PayPilot to bridge the gap between autonomous AI financial intelligence and PayPal's global recurring subscription infrastructure—creating a unified financial co-pilot that doesn't just display transactions, but actively monitors, audits, optimizes, and protects your subscription portfolio.


What it does

PayPilot is an autonomous subscription management and price intelligence platform. It brings proactive financial vigilance to individuals and businesses through five core capabilities:

  1. Autonomous Financial Guardian (Vigil): Powered by Google Gemini with tool execution and search grounding, Vigil continuously audits your connected agreements. It flags underutilized tools (utility score $< 40\%$), detects redundant software overlaps, and prepares safe, staged cancellation or suspension requests requiring your explicit one-click authorization.

  2. Live Price Intelligence Engine: An autonomous price discovery system that verifies live subscription tiers across global regions using an ultra-resilient 5-tier fallback hierarchy: $$\text{Primary: Gemini with Google Search Grounding} \longrightarrow \text{Secondary: Independent Search} \longrightarrow \text{Tertiary: Verified Cache} \longrightarrow \text{Quaternary: Curated Baseline Registry} \longrightarrow \text{Honest Unavailable}$$ It identifies promotional discounts, student rates, and regional price differences while preventing misinformation.

  3. Real-Time Price Radar & Creep Detection: On-demand web auditing that scans your active subscriptions against live vendor pricing. If a vendor quietly hikes their pricing, PayPilot calculates the net monthly and annual budget impact ($\Delta \text{Cost} = \text{New Price} - \text{Original Price}$) and notifies you before your next billing cycle.

  4. Multi-Currency Normalization Engine: Seamlessly unifies mixed-currency subscription portfolios across 75+ global currencies using live ECB/Frankfurter exchange rates with zero rounding drift. Regional plans (such as INR-exclusive services like Swiggy One) preserve their native origin while computing authentic currency equivalents and true monthly run-rates: $$\text{Monthly Equiv} = \begin{cases} \text{Amount}, & \text{Monthly} \ \frac{\text{Amount}}{3}, & \text{Quarterly} \ \frac{\text{Amount}}{12}, & \text{Yearly} \end{cases}$$

  5. Channel3 Universal Product Graph & Perpetual Deal Discovery: Rather than merely canceling software you need, PayPilot scans the Channel3 product graph to discover verified lifetime or discounted software licenses—helping you eliminate recurring SaaS drain permanently.

  6. Full PayPal Sandbox Recurring Lifecycle Management: Complete integration with PayPal's REST billing APIs supporting live recurring agreement creation, secure hosted approvals, status synchronizations, immediate suspensions, and permanent cancellations.


How we built it

PayPilot was architected from the ground up as a modern, high-performance full-stack Next.js application:

  • Frontend & UI Layer: Built with Next.js 16 (App Router), React 19, Tailwind CSS v4, and Lucide Icons. Financial data tables are powered by AG Grid Community Edition, offering high-speed sorting, filtering, and CSV power audits. Interactive 30-day cash flow renewal cliffs are rendered with Recharts.
  • AI Agent & Reasoning (Vigil): Integrated using the modern @google/genai SDK with gemini-3.8-flash. Vigil employs structured function calling declarations (research_subscription_pricing, compare_subscription_plans, analyze_spending, find_alternatives, check_upcoming_renewals, and stage_subscription_action) and search grounding tools.
  • PayPal Subscription Infrastructure: Communicates directly with the PayPal REST API (/v1/oauth2/token, /v1/catalogs/products, /v1/billing/plans, and /v1/billing/subscriptions) with automatic OAuth2 client credential caching and graceful local mock fallbacks.
  • Alternative SaaS Marketplace: Directly interfaces with the Channel3 Universal Product Graph API to retrieve perpetual software licenses and calculate annual savings against recurring subscription tiers.
  • Data Persistence & Local Security: Implements a zero-knowledge local encrypted device vault (localStorage with JSON import/export) allowing users to track private subscriptions locally without requiring external database custody.

Challenges we ran into

  1. Regional Pricing & Currency Drift: Displaying international subscriptions (e.g., an Indian INR plan viewed on a USD or EUR dashboard) without double-conversion errors was challenging. If a user switched currencies multiple times ($USD \rightarrow EUR \rightarrow INR \rightarrow USD$), naive conversions accumulated rounding drift. We solved this by creating an immutable baseline pattern where originalAmount and originalCurrency are permanently anchored, ensuring dynamic conversion is always computed directly from native source truth.

  2. React 19 State Synchronization & Lint Rules: React 19 strictly forbids synchronous setState calls inside useEffect. We refactored form inputs, search parameters, and modal state into clean derived state patterns (useMemo, lazy initializers, and render-phase reconciliation), eliminating cascading renders and achieving a zero-warning build.

  3. Gemini API Model Transition: During active development, Google AI Studio retired earlier preview endpoints (gemini-2.5-flash), requiring an immediate migration to the newly released gemini-3.8-flash. We engineered a multi-candidate fallback system in the API routes so that Vigil maintains continuous uptime with local reasoning fallbacks even if rate limits or quota boundaries are encountered.

  4. Complex Billing Cycle Run-Rates: Subscriptions are billed on monthly, quarterly, and annual cycles. A quarterly \$299 plan is charged in a single \$299 lump sum every 3 months, not \$99.67 each month. We designed PayPilot's billing rate inputs to capture the exact transaction charge amount while cleanly calculating and presenting the monthly run-rate equivalency contextually.


Accomplishments that we're proud of

  • 32/32 Automated Verification Tests: Wrote and passed comprehensive automated test suites covering multi-currency math, cross-rate conversions, 5-tier pricing fallbacks, and modal workflows.
  • Zero-Drift Currency Architecture: Perfectly solved cross-currency subscription tracking across 75+ currencies without losing original purchase authenticity.
  • Vigil's Guardrails & Safe Staging: Engineered a two-step confirmation pattern where the AI cannot execute destructive billing actions autonomously; it stages the action visually, explaining why (e.g. low utility score), and requires user approval.
  • Production Build Cleanliness: 100% clean production build on Next.js 16 and TypeScript with zero ESLint errors and zero TypeScript diagnostics.

What we learned

  • Deep mastery of PayPal's REST Subscription API, including product catalog creation, multi-tier billing plan specifications, and webhook subscription state machines.
  • Advanced prompt engineering and structured tool orchestration using the official @google/genai SDK with Google Search Grounding.
  • The vital importance of defensive fallback architecture in AI applications: an agent should never return a blank error screen when an upstream model or network endpoint is constrained.
  • Building accessible, high-density financial dashboards with AG Grid, Recharts, and Tailwind CSS.

What's next for PayPilot

  • Automated Virtual Card Provisions: Integrating virtual debit card generation for trial subscriptions that automatically self-terminate after the trial period.
  • Bank Feed & Open Banking Sync: Connecting Plaid and Open Banking APIs to automatically detect recurring bank statements and import offline subscriptions.
  • Multi-Seat Team Workspaces: Expanding PayPilot for startups and enterprise finance teams to assign software seat utilization tracking to team members.
  • Proactive Renewal Push Notifications: Web Push and email notifications delivered 48 hours prior to high-value annual renewal cliffs.

Built With

Share this project:

Updates

Submission history