The problem
Freelancers often keep project scope, client approvals, invoices, and dispute records in different places. When a payment is challenged, rebuilding what was agreed and what happened takes time—and unsupported claims can make the situation worse.
What ProofPay does
ProofPay connects project milestones, client review, payment records, and dispute preparation in one workflow. Freelancers can define milestone scope and acceptance criteria, share a private review link, and record a client approval or change request. Payment and dispute records from PayPal Sandbox can then be connected to the relevant project work.
When a dispute arrives, Gemini helps assess the available information and draft a response. ProofPay checks evidence references and filters claims that fail those checks. The freelancer reviews and edits the response; edits invalidate prior approval. Before submission, the server checks PayPal’s currently allowed actions again. AI does not submit the response, and PayPal—not ProofPay—decides the dispute.
How we built it
The frontend uses React, Vite, Tailwind CSS, React Router, and AG Grid Community. The Node.js and Express server uses Mongoose and MongoDB Atlas. It connects to PayPal Sandbox Invoicing, Disputes, and verified webhooks. Gemini provides structured assessments and response drafts; application rules validate evidence references and require human approval. PayPal credentials stay on the server.
Challenges and what we learned
PayPal Sandbox behavior and account-region differences made invoice and dispute testing less predictable than a local checkout. We also fixed a Mongoose schema issue involving a nested field named type and configured Express correctly behind the hosting proxy.
Our main lesson: a convincing AI response is not necessarily a supported one. The workflow must show where claims come from, filter unsupported claims, and leave the final decision with a person. Integrations also change state, so ProofPay checks what PayPal currently allows immediately before submission.
We exercised the flow with a $5 Sandbox test: invoice payment, dispute import and project mapping, AI analysis, human-approved response, and a later PayPal-reported resolved status. No service was delivered in that test, no live funds were involved, and this Sandbox result is not a promise about future disputes.
Built With
- ag-grid-community
- ai
- express.js
- gemini-3.5-flash-lite
- gemini-api
- javascript
- mongodb-atlas
- mongoose
- node.js
- paypal-disputes-api
- paypal-invoicing-api
- paypal-sandbox
- paypal-webhooks
- react
- react-router
- render
- rest-api
- tailwind-css
- vite