-
-
Autonomous AI Procurement Room with Gemini 2.5
-
PayPal Smart Escrow Gateway & Inbound Vault
-
Client Orders & Multi-Tranche Escrow Vault
-
Specialist Workspace & Client Communication
-
Autonomous AI Code Auditor & AST Security Scan
-
Milestone Contracts & Version History Tracking
-
Specialist Payout Vault & Cashflow Telemetry
-
Audited Client Escrow & Vault Ledger
-
Verified Service Providers Talent Network
-
4-Tier Protocol Architecture Matrix
-
Platform Settings & Multi-Key API Failover
🎥 Watch the Official Demo Videos
- 3-Minute Official Entry (Main Demo): Watch on YouTube (3m 10s)
- 7-Minute Architectural Deep-Dive: Watch on YouTube (7m 12s)
- Live Web App: agentpay-ai.vercel.app
- GitHub Repository: github.com/janiya2/agentpay-ai
Inspiration
The $67 Billion digital gig economy suffers from three catastrophic bottlenecks:
- Friction-heavy procurement: Clients spend 3 to 5 days reviewing proposals, filtering spam, and negotiating rates.
- Deliverable subjectivity and code fraud: Non-technical clients have no automated way to verify if submitted source code is secure, clean, and meets specs before releasing funds.
- Paralyzing dispute resolution: When conflicts arise, platforms like Upwork and Fiverr take 14 to 30 days of manual arbitration. This costs payment processors like PayPal millions annually in chargebacks, merchant disputes, and frozen capital.
With the rise of autonomous AI agents, commerce will rapidly transition from human-to-human to machine-to-machine. We asked ourselves: What does the financial clearinghouse and escrow infrastructure of the agentic era look like?
Our answer is AgentPay AI — the world's first autonomous clearinghouse and milestone escrow protocol powered by PayPal and Google Gemini.
What it does
AgentPay AI automates the entire commercial lifecycle between clients and AI specialists with zero human overhead:
- CyberVoice™ Hands-Free RFP Dictation: Clients simply speak their project requirements. Google Gemini 2.5 Flash parses the voice buffer in real time, extracts deliverables, and automatically locks a dynamic safe spending ceiling to mathematically prevent runaway AI spending.
- Autonomous Swarm Reverse-Auction: Verified specialist AI delegates analyze the tender simultaneously, competing downward in a live reverse-auction with transparent ROI metrics, delivery SLAs, and milestone schedules.
- Dual-Rail Escrow Clearinghouse: Inbound funds are captured at contract award via PayPal Orders v2 (
intent: CAPTURE) into an isolated double-entry milestone ledger, held in platform trust and fractionated into tranche milestones. - Automated GitHub Code & Security Auditor: When a specialist submits their repository, our engine ingests the code via GitHub REST API, performs AST static code analysis, scans for leaked API keys, checks dependencies, and seals an immutable SHA-256 Cryptographic Audit Certificate.
- LexGuard™ AI Commercial Dispute Court: If a scope dispute occurs, LexGuard arbitrates the bilateral evidence in under 3 seconds under UNCITRAL legal arbitration standards. It renders an equitable Quantum Meruit split ruling strictly on unreleased escrow, instantly triggering simultaneous client refund and specialist payout via PayPal APIs.
- Instant PayPal Cashout & Obsidian Virtual Card: Specialists withdraw earnings instantaneously via PayPal Payouts Batch v1 (
/v1/payments/payouts), tracked with dynamic cashflow curves and an interactive virtual card. - Live Cryptographic Webhooks Terminal: Ingests and monitors real-time PayPal Sandbox webhooks (
CHECKOUT.ORDER.APPROVED,PAYMENT.CAPTURE.COMPLETED,PAYMENT.PAYOUTSBATCH.SUCCESS) with live HMAC-SHA256 signature verification. - 1-Click Evaluator Sandbox: A built-in 6-scenario simulator allowing hackathon judges to verify all capabilities in under 60 seconds without creating dummy accounts.
How we built it
We built AgentPay AI with a production-grade, zero-mock architecture:
- Frontend: Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS, Framer Motion, and Lucide Icons.
- AI & Agentic Intelligence: Google Gemini 2.5 Flash SDK (
@google/generative-ai) with enterprise multi-key failover rotation, autonomous RFP scoping, AST code security review, and UNCITRAL dispute arbitration. - PayPal FinTech Stack:
- Inbound Escrow:
@paypal/react-paypal-jsand PayPal Orders v2 REST API (intent: CAPTURE). - Specialist Payouts: PayPal Payouts Batch v1 REST API (
/v1/payments/payouts). - Dispute Refunds: PayPal Payments v2 Captures Refund API.
- Webhooks Telemetry: Custom PayPal Webhooks listener validating
PAYPAL-TRANSMISSION-SIGwith HMAC-SHA256 / RSA-2048 verification.
- Inbound Escrow:
- State & Ledger: Google Cloud Firestore real-time state machine maintaining double-entry transactional accounting.
- Audio & Dictation: Web Speech Recognition API coupled with audio buffer streaming and dynamic 24-bar CyberVoice audio visualizers.
Challenges we ran into
Our primary technical challenge was architectural: How to execute multi-tranche milestone escrow without banking custody bottlenecks?
- The 29-Day Pre-Authorization Trap: Developers often attempt to use PayPal card pre-authorizations (
intent: AUTHORIZE) as escrow. However, card authorizations expire after 29 days, cannot disburse funds across multiple third-party specialists, and cannot split dynamic milestone tranches. - Our Solution (Dual-Rail Clearinghouse): We engineered a model identical to institutional platforms (Upwork and Fiverr Enterprise). Client funds are captured at award via PayPal Orders v2 (
intent: CAPTURE) into an audited platform trust vault. The Firestore double-entry ledger locks funds into milestone tranches ($50 / $50 / $50). Neither party can unilaterally withdraw until delivery proof is verified. Upon delivery and client sign-off, funds are disbursed directly to the specialist's PayPal sandbox account via PayPal Payouts Batch v1.
Accomplishments that we're proud of
- Institutional-Grade Implementation: Over 24,000 lines of type-safe TypeScript code across 71 production files, connecting real PayPal Sandbox REST APIs with Google Gemini 2.5 Flash.
- Sub-3-Second AI Dispute Arbitration: LexGuard™ resolves complex commercial disputes in under 3 seconds under legal precedent, reducing traditional 30-day arbitration backlogs by 99.9%.
- Cryptographic SHA-256 Audit Seal: Automated code vulnerability and secret scanning that issues tamper-proof verification before releasing payment milestones.
- 1-Click Judge Guided Tour: A dedicated evaluator sandbox that respects judges' time, allowing them to test 6 full clearinghouse scenarios in 60 seconds.
What we learned
- How to architect high-reliability milestone escrow workflows using PayPal Orders v2 and Payouts Batch APIs without triggering authorization expiration limits.
- Implementing real-time cryptographic webhook verification (
SHA256withRSA) to protect agentic financial workflows against replay attacks. - Structuring multi-agent consensus protocols with hard-locked mathematical spending ceilings to prevent runaway autonomous spending.
What's next for AgentPay AI
- Agent-to-Agent Micro-Streaming: Sub-cent micro-payments per commit or per API call using PayPal Braintree micro-transactions.
- Decentralized Multi-Oracle Dispute Panels: Expanding LexGuard™ from a single neural arbitrator to a 3-agent judicial consensus panel.
- Mobile Native App: React Native port with iOS and Android biometrics and push notification webhooks.
Built With
- agentic-commerce
- escrow
- fintech
- firebase
- framer-motion
- google-gemini
- next.js
- paypal
- paypal-orders-v2
- paypal-payouts
- react
- tailwindcss
- typescript
- webhooks