Inspiration
Small sellers paid through PayPal lose money in quiet ways. Funds are held for up to 21 days without tracking, "empty box" and forwarding-address scams happen, and disputes push them over PayPal's 1.5% limit, where fees double and response time drops from 10 days to 3. Sellers on Reddit, Trustpilot and the eBay and Shopify forums describe frozen accounts and lost disputes. Cross-border sellers in India also rarely know what a $100 sale actually puts in their bank after fees and currency conversion.
What it does
- Scam Radar: checks every new order and buyer message before you ship (forwarding addresses, address changes, "my friend will pick it up", payment requests outside PayPal) and says Safe to ship, Check first or Don't ship yet.
- Proof Vault: Gemini vision checks packing photos (right item, label visible, box sealed) and saves them with a time stamp. They're attached to dispute evidence automatically.
- Real earnings + money countdown: PayPal's fee breakdown plus the live FBIL rate shows what you really keep in ₹, and when the money should arrive.
- Tracking autopilot: paste a courier email, the AI pulls out the tracking number, and it's added to the PayPal order so held funds can be released sooner.
- Complaint fixer: the AI rates an unhappy buyer's message and suggests the cheapest fair fix, comparing the cost of a refund with a lost dispute. The refund goes through PayPal only after you approve it.
- Dispute responder: recommends fight or accept with the money maths, writes the evidence, and submits it through the Disputes API.
- Agent chat: Gemini function calling across 6 tools. Every PayPal action needs your Confirm click.
- Account health: your dispute rate against PayPal's 1.5% line, with warnings like "1 more dispute = $30 fee".
How we built it
Next.js 15, TypeScript, Tailwind, shadcn/ui and Motion, deployed on Render.
- PayPal (sandbox): JS SDK Checkout, Orders v2 (create, capture, add tracking), Payments v2 refunds, Customer Disputes v1 (list, get, provide-evidence with files, accept-claim), Webhooks.
- AI: Google Gemini 2.5 Flash / Flash-Lite for the function-calling agent, vision checks on packing photos, extraction, risk classification and drafting.
- Safety: the AI only proposes. Money maths and limits are checked in code, and every action that touches PayPal needs the seller's approval.
Challenges we ran into
- PayPal checkout failed with India-registered sandbox accounts, so we moved to US sandbox accounts and set the buyer country.
- Sandbox can't create real holds or account limits, so those parts are clearly labelled as simulated.
- "Item not received" disputes reject generic evidence; they need proof of fulfilment.
Accomplishments that we're proud of
A working end-to-end flow on real PayPal sandbox APIs, from purchase to scam check, photo proof, tracking, refund, dispute evidence and agent chat, with a human approving every money action.
What's next
Shopify and eBay order sync, real courier tracking APIs, payout-to-bank reconciliation, Tamil and Hindi explanations, and buyer-side protection.
Built With
- gemini
- google-ai
- motion
- nextjs
- paypal
- paypal-disputes-api
- paypal-js-sdk
- paypal-orders-api
- render
- shadcn-ui
- tailwindcss
- typescript
