Inspiration
Managing money as a student or young earner is notoriously stressful. Traditional banking and budgeting applications treat finances with rigid categories and punitive red alerts when overspending occurs, causing anxiety and app abandonment. When an unexpected expense happens (a textbook, medical bill, or social gathering), traditional apps fail to guide the user on how to recover gracefully.
We built PayPulse AI for the PayPal AI Hackathon to transform personal budgeting from a cold ledger into an empathetic, intelligent financial companion. Powered by real-time conversational AI and native PayPal REST API integration, PayPulse AI absorbs real-world financial volatility, removes guilt, and keeps young earners on track toward their life goals.
What It Does
PayPulse AI provides an end-to-end autonomous financial management experience:
- 7-Question Guided Onboarding: Analyzes net income, fixed commitments (rent, utilities), and calculates the real monthly surplus: $$\text{Surplus} = \text{Income} - \text{Fixed Expenses}$$
- Deterministic 40/30/30 Surplus Allocation:
- 40% to an Emergency Cushion
- 30% to Long-term Goals
- 30% to Safe Flexible Spending
- Daily Spend Velocity Engine: Rather than overwhelming users with complex monthly spreadsheets, PayPulse calculates a crystal-clear daily pacing rate: $$V_d = \frac{F_{\text{remaining}}}{D_{\text{remaining}}}$$ For a ₹1,500 monthly flexible balance over 19 days, the safe baseline is ₹78/day.
- Empathetic Volatility Absorption: When an unexpected ₹1,000 expense strikes, PayPulse dynamically re-calibrates the daily velocity to ₹26/day without scolding or shaming the user.
- Conversational AI Companion: Powered by high-speed Groq inference (Qwen & Llama 3 models), delivering contextual mathematical advice, budget breakdowns, and instant reassurance.
- Smart Cheaper Alternative Finder: Recommends verified student discounts (e.g. Spotify Student, Notion Education, refurbished laptops) with transparent savings callouts.
- Long-Term Compound Savings Intelligence: Models 1 to 10-year wealth projections assuming a 7% annual yield: $$A = P \left(1 + \frac{r}{n}\right)^{nt}$$
- Native PayPal REST API v2 Integration: One-click PayPal Sandbox OAuth 2.0 token generation, dynamic order creation, and capture for funding savings goals and paying expenses.
How We Built It
- Frontend: Next.js 14 (App Router), React, TypeScript, and Tailwind CSS with a responsive dark-mode UI.
- Data Visualizations: Recharts for interactive surplus breakdowns, spending velocity gauges, and multi-year compound interest curves.
- AI Brain: Groq Cloud inference running high-throughput open-weights models (
qwen/qwen-2.5-coder-32b,llama-3.3-70b-versatile) with strict prompt engineering for mathematical rigor and empathetic tone. - Payments: PayPal REST API v2 (
/v1/oauth2/token,/v2/checkout/orders) supporting seamless order creation and capture in the sandbox environment. - Architecture: Unified full-stack serverless deployment on Vercel with zero cross-origin latency, paired with a FastAPI and SQLite backend.
- Testing & Demo: Playwright automated visual walkthrough and Microsoft Edge neural speech synthesis (
en-US-ChristopherNeural) for the high-definition product walkthrough video.
Challenges We Ran Into
- Balancing Mathematical Determinism with Generative AI: LLMs can hallucinate numbers. We designed a dual-engine architecture where exact financial calculations (surplus, daily velocity, compound growth) are computed deterministically by the backend engine, while the LLM receives the pre-computed metrics as structured context to provide empathetic, factually grounded guidance.
- Cross-Service Deployment: Initially separating frontend and backend across two separate cloud hosts created cross-origin security headers and cold-start latency. We resolved this by porting the API handlers directly into Next.js App Router API routes on Vercel, achieving sub-100ms response times.
- PayPal Sandbox Authentication Flow: Integrating sandbox credentials across serverless functions required strict server-side environment variable isolation to prevent leaking secrets to client bundles.
Accomplishments That We're Proud Of
- A 100% functional, end-to-end full-stack app deployed live on Vercel.
- Realistic simulation of real-life volatility that actively adjusts daily spending pacing in real time.
- Direct PayPal REST API order creation with real sandbox transaction IDs.
- A clean, accessible financial UI tailored specifically for young earners and students.
What We Learned
- How to orchestrate real-time financial APIs alongside conversational LLMs.
- The psychological importance of guilt-free UI design in personal finance applications.
- How to optimize high-speed Next.js serverless route handlers for instant AI response generation.
What's Next for PayPulse AI
- Automated Round-ups via PayPal: Automatically rounding up everyday transactions and routing the spare change directly into the 40% emergency cushion.
- Multi-Currency Support: Expanding support for USD, EUR, and GBP with live exchange rate hedging.
- Peer-to-Peer Shared Goal Splits: Enabling roommates and student groups to pool flexible surplus toward shared goals using PayPal P2P splits.
