Inspiration

Freelancers and small businesses lose billions each year in late or forgotten payments simply because managing invoices, reconciling revenue, and following up on overdue bills is tedious, uncomfortable, and manual. Traditional payment dashboards are data-rich but operationally friction-heavy. We built SmartPay Agent to solve this: an autonomous AI assistant that bridges conversational natural language with PayPal's robust financial infrastructure.

What it does

SmartPay Agent allows business owners to manage their entire financial lifecycle through a simple chat interface:

  • Instant Invoicing: Creates and dispatches official PayPal invoices in under 3 seconds using natural language (e.g., "Invoice [email protected] $500 for logo design").
  • Live Invoice Tracking: Pulls real-time invoice statuses from PayPal to show paid, unpaid, and sent bills with clear status icons.
  • Automated Revenue Analytics: Aggregates transaction reporting data to provide total earnings, expenses, and net profit summaries.
  • Autonomous Payment Follow-ups: Automatically detects overdue accounts and dispatches official PayPal reminder notifications with zero awkwardness.

How we built it

  • AI Agent Engine: Built using Google Gemini AI with agentic tool calling / function calling, converting plain English intent into executable API payloads.
  • Payment & Backend Architecture: FastAPI (Python 3.13) integrated directly with PayPal Sandbox REST APIs (Invoicing v2, Orders v2, OAuth2 Token Management, and Reporting API).
  • Frontend & UX: Modern, responsive chat interface built with React 18, Vite, Axios, and Markdown rendering.

Challenges we ran into

Integrating cutting-edge Python 3.13 libraries required building custom pre-compiled wheels. We also navigated strict CORS headers between Vite and FastAPI, handled OAuth2 token caching to prevent rate-limiting, and designed an intelligent fallback resilience layer so transient AI traffic spikes never block critical PayPal transactions.

Accomplishments that we're proud of

We built a completely functional, end-to-end autonomous agent that doesn't just display mock data — it executes real sandbox transactions on PayPal's developer ecosystem with real generated Invoice and Order IDs in under a second.

What we learned

We learned the depth of PayPal's REST APIs, how to structure enterprise-grade function declarations for LLMs, and how to build resilient financial agents that handle state, security, and edge-case exceptions gracefully.

What's next for SmartPay Agent

We plan to introduce multi-currency dynamic conversion, subscription and recurring payment automations, and direct WhatsApp / Slack bot integrations so merchants can manage their cash flow directly from their favorite messaging apps.

Built With

Share this project:

Updates

Submission history