Inspiration

Group purchasing—whether roommates furnishing an apartment, teammates ordering late-night hackathon dinner, or friends splitting camping gear—always breaks down at checkout. One person fronts hundreds of dollars, spends 20 minutes manually calculating who ate what, who opted out of alcohol, and how to divide tax and tip without rounding errors, and then spends days chasing friends to get paid back.

"CartSplit AI" turns group shopping and shared receipts into an autonomous "Agentic Commerce" workflow: discover products via Channel3, assign items or usage weights with a tap, verify penny-exact fairness math, and issue individual PayPal Sandbox checkout orders and invoices for every participant simultaneously.

What It Does

  • "Channel3 AI Product Concierge & Receipt Parser": Users can search and enrich real products via the "Channel3 Product Discovery API" or load itemized group receipts across 4 built-in social scenarios (Roommate Coffee & Kitchen Setup, Hackathon Dinner & Drinks, Podcast Studio Co-Buy, and Weekend Camping Supplies).
  • FairSplit Mathematician Agent (Zero Rounding Drift): Supports Equal Split, Usage/Ownership Weight Split (e.g., 50% / 30% / 20%), and Item-Level Member Assignment with dietary/opt-out rules (e.g., vegetarian or alcohol-free exclusions). Tax and tip are distributed proportionally to each participant's exact item subtotal using largest-remainder penny allocation, guaranteeing zero rounding drift.
  • "Per-Member PayPal Sandbox Checkout & Invoicing": Our "PayPal Settlement Collector Agent" invokes @paypal/agent-toolkit schemas (paypal_create_order, paypal_capture_order, paypal_create_draft_invoice) against https://api-m.sandbox.paypal.com to create dedicated PayPal Orders v2 (POST /v2/checkout/orders with PayPal-Request-Id idempotency keys) and Invoicing v2 requests for each participant's share.
  • 1-Click Judge Auto-Pilot & Polite Chaser Generator: Includes a 1-click Auto-Pilot that executes the full multi-member PayPal Sandbox order creation and settlement lifecycle, generates AI-tailored polite payment reminder messages, exports PNG/CSV split receipts, and logs every live HTTP request and paypal-debug-id in the "Live API Telemetry Inspector".

How We Built It (Tools & AI Statement)

  1. PayPal Developer Platform (Sandbox Environment): Integrated PayPal OAuth 2.0 (POST /v1/oauth2/token), PayPal Orders v2 REST API (POST /v2/checkout/orders, GET /v2/checkout/orders/{id}, POST /v2/checkout/orders/{id}/capture), PayPal Invoicing v2 API (POST /v2/invoicing/invoices), and @paypal/agent-toolkit structured function-calling tools.
  2. AI Models & Coding Agents: Built with OpenAI Codex and OpenAI API driving the 3-agent orchestration pipeline (Channel3 Shopping Concierge Agent, FairSplit Mathematician Agent, and PayPal Settlement Collector Agent).
  3. Sponsor Tools Integrated:
    • Channel3 API: Powers live product discovery, price lookup, and catalog enrichment for group shopping carts.
    • APIMatic Context Plugin for PayPal: Used to validate multi-order idempotency headers, Orders v2 schemas, and HATEOAS approval link handling.
    • Render: Hosts the live production web service with managed Sandbox credentials.

Built With

  • apimatic
  • channel3
  • codex
  • node.js
  • openai
  • paypal
  • paypal-agent-toolkit
  • paypal-orders-api
  • paypal-sandbox
  • render
Share this project:

Updates

Submission history