Inspiration
Every growing e-commerce merchant dreads the sudden notification: "Your funds are on hold." When a seller's business takes off or seasonal volume spikes, PayPal's risk engine places reserves or holds on payouts to protect against fulfillment fraud.
For honest merchants, this creates a cash-flow crisis. Today’s dispute and hold resolution process is painful: merchants blindly upload disorganized PDFs, wait 3 to 7 business days, and often receive generic rejections because a single line item didn't match. Meanwhile, human PayPal risk analysts spend hours manually cross-checking invoices, purchase orders, and shipping manifests. We built ResolveAI to turn this week-long friction into a 3-second automated verification.
What it does
PayPal ResolveAI is an intelligent evidence reconciliation platform that checks seller proof before submission:
- Automated Document Triage & Client-Side Redaction: Merchants upload invoices, purchase orders, and carrier manifests. Before any data leaves the browser, sensitive PII (credit cards, SSNs, phone numbers) is redacted and documents are cryptographically fingerprinted using SHA-256 hashes.
- Three-Way Evidence Reconciliation: The engine cross-references the three core pillars of commercial proof:
- Wholesale Purchase Order: Validates buyer identity, order quantities, and agreed ship-to address.
- Supplier Invoice: Verifies unit pricing, billed quantities, and physical goods classification.
- Carrier Delivery Manifest / Proof of Delivery: Confirms carrier tracking, destination match, weight consistency, and recipient signatures for orders exceeding PayPal's $750 threshold.
- Real-Time Preflight Checklist: Flags quantity conflicts, mismatched shipping addresses, or missing delivery signatures in red with plain-language corrective instructions before submission.
- Fast-Track Resolution & Cryptographic Receipt: Once all preflight checks pass and PayPal Seller Protection criteria are met, risk analysts can release reserves in one click (or trigger simulated automated settlement), generating an immutable, time-stamped audit receipt.
How we built it
- Full-Stack Application: Built with React 19, TypeScript, TanStack Start, and Tailwind CSS.
- Client-Side Privacy Engine: Implemented local regex-based PII redaction and Web Crypto SHA-256 fingerprinting to protect consumer data before processing.
- Preflight & Seller Protection Rules Engine: Built custom reconciliation logic mapping directly to PayPal's Seller Protection guidelines (checking delivery proof, tracking verification, address uniformity, and signature requirements for transactions over $750).
- Simulated PayPal Event Stream: Modeled an event-driven architecture tracking real-time PayPal lifecycle events (
PAYMENT.CAPTURE.COMPLETED,RISK.RESERVE.HELD,EVIDENCE.SUBMITTED,HOLD.RELEASED). - Interactive Multi-Role Demo: Designed a dual-view portal allowing judges to experience the flow as both the merchant sending proof and the PayPal risk analyst reviewing the case.
Challenges we ran into
- Reconciling Unstructured Document Variations: Supplier invoices, wholesale POs, and carrier manifests come in completely different layouts, measurement units (kg vs. lbs), and naming conventions. Building a normalization layer that accurately catches discrepancies (like 100 units on a PO vs. 500 units on an invoice) without false alarms required meticulous parsing rules.
- Balancing Privacy with Proof: Risk review requires proof of legitimate fulfillment, but merchants shouldn't expose sensitive consumer payment card numbers or personal identifying data. We solved this by enforcing client-side redaction before ingestion.
- Modeling PayPal's High-Value Seller Protection Rules: Accurately reflecting PayPal's risk threshold—such as requiring signed proof of delivery specifically when order amounts exceed $750—to ensure simulated holds mirror real-world compliance standards.
Accomplishments that we're proud of
- Created a seamless, zero-friction preflight checklist that reduces evidence rejection rates from days of back-and-forth to instant self-correction.
- Designed three distinct, one-click test scenarios (Clean Wholesale Spike, Quantity Mismatch, Missing Delivery Signature) so anyone can immediately see the reconciliation engine catch subtle discrepancies.
- Generated verifiable audit trails featuring cryptographic document hashes, exact timestamps, and structured decision metadata.
What we learned
- How much merchant churn and support overhead can be eliminated simply by providing real-time pre-submission feedback rather than post-rejection explanations.
- The depth and precision of PayPal's Seller Protection criteria and how automating evidence parity empowers honest sellers while keeping risk barriers high against fraud.
What's next for ResolveAI
- Live PayPal Resolution Center API Integration: Connecting directly into PayPal's Disputes and Case Management REST APIs to ingest active merchant holds and auto-attach verified evidence packages.
- Carrier API Webhooks: Direct integrations with FedEx, UPS, and DHL to auto-pull signed Proof of Delivery (POD) directly from tracking numbers.
- Multi-Modal Document Vision: Using multi-modal AI models to extract handwritten delivery signatures, bill of lading stamps, and complex multi-page invoice tables.
Built With
- lovable
- react
- supabase
- vite