PayGenie AI

Conversational AI billing copilot powered by Gemini & PayPal Orders v2 that turns natural language into settled transactions & audit-ready PDFs in seconds.

Comment

Inspiration

Freelancers, agency founders, and consultants lose more than 10 hours every month wrestling with rigid billing software, manually calculating discounts and tax rates, and chasing unpaid invoices. We built PayGenie AI to bridge cutting-edge conversational artificial intelligence with frictionless global payments — enabling solopreneurs to turn natural language into settled PayPal transactions and audit-ready receipts in seconds.

What it does

PayGenie AI is an intelligent conversational billing copilot:

  • Natural Language Invoicing: Describe billables in plain English (e.g., "Bill Acme for 12 hours fullstack dev at $75/hr with a 10% discount and 8% tax"). The AI parses items, calculates discounts, computes sales taxes, and generates structured invoices.
  • Client Workspace Isolation: Dedicated per-client workspaces with independent chat histories, multi-invoice tracking, and client roster management.
  • 1-Click PayPal Settlement: Clients receive secure payment links powered by PayPal Orders v2 REST API featuring 256-bit SSL encryption, PayPal sandbox checkout, and instantaneous capture.
  • Real-Time Synchronized Accounting Ledger: A live merchant balance strip and master settlement ledger synchronized in real time with Neon Serverless PostgreSQL and optimistic cross-tab broadcasts.
  • Audit-Ready Stamped PDFs: Auto-generates formal invoice PDFs stamped with verified Emerald Green STATUS: PAID VIA PAYPAL credentials and PayPal Capture Transaction IDs.

How we built it

  • Frontend & UI: Next.js 16 (App Router), React 19, Tailwind CSS, Lucide Icons, and Sonner notifications.
  • Conversational Intelligence: Google Gemini API configured for structured entity extraction, hourly rate calculation, and multi-line item generation.
  • Payments & Checkout: PayPal Developer Platform with Orders v2 REST API (/v2/checkout/orders create and capture endpoints) integrated with PayPal JavaScript SDK.
  • Database & Persistence: Neon Serverless PostgreSQL (AWS us-east-1) storing clients, message histories, and invoice ledger entries.
  • Deployment: Vercel Edge Network.

Challenges we ran into

  • Isolated Thread State: Ensuring that invoice drafts and payment statuses don't bleed across different clients or between multiple invoices of the same client.
  • Real-Time Cross-Tab Settlement: Harmonizing serverless payment capture callbacks with instant UI updates on the merchant ledger without requiring page refreshes.

Accomplishments that we're proud of

  • Achieving end-to-end invoice creation to live PayPal Sandbox capture in under 30 seconds.
  • Fully automated audit-ready PDF generation stamped with official PayPal capture hashes.
  • Seamless zero-friction UX with quick-start billing templates and bulk client management.

What we learned

  • How to orchestrate Google Gemini's reasoning for zero-error financial math and tax logic.
  • Deep integration with PayPal Orders v2 REST APIs and idempotent payment capture.

What's next for PayGenie AI

  • Automated WhatsApp and email payment reminders via Twilio.
  • Multi-currency dynamic conversion via PayPal Payouts.
  • Recurring milestone contracts and client escrow.

Built With

Share this project:

Updates

Submission history