- APIMatic-Verified OpenAPI 3.1: All endpoints and payloads are strictly typed with Pydantic v2 and documented via OpenAPI 3.1 (
docs/openapi.json), enabling instant integration into APIMatic Context Plugins.
4. Sponsor Tools & How They Are Used
| Sponsor / Technology | Concrete Role in PayPilot |
|---|---|
| PayPal Developer Platform | Powers the core payment lifecycle using Orders v2 REST APIs (/v2/checkout/orders), @paypal/react-paypal-js SDK buttons, idempotent server captures (PayPal-Request-Id), and Sandbox verification. |
| Channel3 API | Acts as the primary agentic discovery engine, querying over 25,000 merchant stores with query rewriting, SKU matching, and live multi-offer pricing comparisons. |
| Google Gemini 2.0 Flash | Parses unstructured shopping requests into structured JSON briefs containing category, numeric budget, mandatory feature tags, and negative exclusion terms. |
| AG Grid Integration | Inspires the Payments & Orders Ledger table, providing high-performance transaction sorting, quick status filters (PAID, AWAITING_APPROVAL, CANCELLED), and financial CSV export. |
| APIMatic | Validates PayPilot's OpenAPI 3.1 specification (docs/openapi.json), powering zero-hallucination IDE context plugins and multi-language SDK generation. |
| Render | Hosts the production deployment blueprint (render.yaml) featuring auto-provisioned PostgreSQL and automated zero-downtime healthcheck probes. |
5. Differentiators & Why PayPilot Wins
- No Autonomous Spending: AI assists and negotiates; code enforces policy; the human clicks PayPal Approve.
- Honest Architecture: We clearly distinguish between external market comparison offers (via Channel3) and purchasable demonstration inventory.
- Resilience & Fallbacks: If external API keys are not supplied during initial setup, PayPilot gracefully falls back to deterministic rule-based parsing and sandbox simulation without crashing.
- Comprehensive Test Suite: 45/45 backend unit/integration tests (
pytest) and 7/7 frontend tests (vitest) passing in CI, with clean production build (tsc -b && vite build).
6. Demo Video & Submission Links
- Repository: https://github.com/puneet2409/PayPilot
- Hosted Demo: [Render / Cloud Hosted Demo URL]
- Demo Video (YouTube, < 3 Minutes): [YouTube Video Link]
- Interactive OpenAPI 3.1 Swagger Docs:
http://localhost:8000/docs - APIMatic Spec:
docs/openapi.json - Demo Walkthrough Script:
docs/DEMO_SCRIPT.md
Built With
- ag-grid
- apimatic
- channel3-api
- css3
- fastapi
- gemini-api
- google-gemini
- hmac-sha256
- html5
- javascript
- openapi-3.1
- paypal
- paypal-orders-v2
- paypal-sdk
- postgresql
- pydantic
- python
- react
- render
- sqlalchemy
- sqlite
- tailwindcss
- typescript
- vite
