Boltpay.ai

Turn plain-English prompts into live PayPal checkout links with automated tax categorization and real-time webhook reconciliation.

Comment

Inspiration Freelancers and independent creators spend too much time manually drafting invoices, categorizing revenue for taxes, and refreshing payment dashboards to see when clients pay. BoltPay.ai was built to turn a simple natural-language work summary into a live, payable PayPal invoice with automated accounting categorization and instant webhook reconciliation.

What it does

  • Natural Language Invoice Generation: Users type plain-English descriptions of completed work (client, deliverables, amount, and due date), and an AI agent parses the structured invoice payload.
  • Automated Accounting Categorization: Uses NLP classification to assign each invoice to a standard tax/accounting category automatically.
  • Direct PayPal Publishing: Creates, sends, and generates live checkout links through the PayPal Invoicing v2 API.
  • Real-Time Webhook Reconciliation: Listens for incoming PayPal payment events (INVOICING.INVOICE.PAID, INVOICING.INVOICE.UPDATED, and PAYMENT.CAPTURE.COMPLETED) and automatically updates the dashboard status from Sent to Paid with instant toast notifications.

How we built it

  • Frontend: Built with React and Vite, featuring real-time dashboard polling (every 3 seconds) and toast alerts when webhook confirmations arrive.
  • Backend: Built with Python and Flask (Flask-CORS), exposing REST endpoints for AI invoice generation, invoice state management, and PayPal webhook ingestion.
  • AI Orchestration: Powered by LangGraph and the Google Gemini API to extract structured billing parameters and classify accounting categories.
  • Payments & Webhooks: Integrated with the PayPal Invoicing v2 API in Sandbox mode and exposed locally via ngrok to receive live PayPal webhook callbacks.

Challenges we ran into

  • PayPal Invoice ID Formatting in Webhooks: Webhook payloads returned invoice IDs in slightly varying formats compared to creation responses. We built a regex ID normalization helper (clean_id) so incoming webhook events reliably match stored invoices.
  • Local Webhook Tunneling: Configuring ngrok tunneling and aligning PayPal Sandbox webhook subscriptions across both Invoicing and Payment Capture events required careful debugging and verification.

Accomplishments that we're proud of

  • Delivering a complete end-to-end agentic payment loop—from plain-English prompt to live PayPal Sandbox checkout and automatic UI reconciliation—without manual status updates.

What's next for BoltPay.ai

  • Migrating local JSON storage to PostgreSQL/Supabase with multi-user authentication.
  • Supporting recurring retainer invoices, automated payment reminders, and direct CSV/QuickBooks tax exports.

Built With

Share this project:

Updates

Submission history