Settle – Work Delivered. Payments Protected.
Inspiration
Freelancing and independent contracting are built on trust, but trust is not always enough. Freelancers worry about completing work without receiving payment, while clients worry about releasing money for incomplete or unsatisfactory deliverables. Disagreements over project requirements, acceptance criteria, and work quality can turn otherwise successful collaborations into stressful experiences.
We wanted to address this gap by building a platform where payment protection and work verification go hand in hand.
That idea led to Settle, an AI-powered milestone-based payment platform that brings together payment authorization, automated code verification, and AI-assisted dispute resolution. Instead of relying entirely on subjective judgments, Settle establishes clear acceptance criteria before work begins and uses evidence from actual GitHub repositories to evaluate submitted deliverables.
What We Built
Settle introduces a three-stage workflow:
- Fund – Establish Payment Commitment
Clients create projects and divide them into milestones with clearly defined deliverables and acceptance criteria. Our AI-powered Scoper helps transform project descriptions into structured milestones.
Through PayPal integration, clients authorize milestone payments before development begins. This establishes a payment commitment while giving freelancers visibility into the authorized amount.
- Verify – Evaluate Actual Work Using AI
When a freelancer completes a milestone, they submit their GitHub repository for review.
Our AI-powered Reviewer, built using Google Gemini and GitHub integration, examines the repository against each predefined acceptance criterion.
Rather than producing a simple completion score, it generates criterion-level evaluations with supporting repository evidence, including relevant files and code references. This helps clients understand what was implemented, what is missing, and why a requirement passed or failed.
- Release – Resolve Disagreements Through AI Mediation
Not every disagreement has a straightforward answer. To address this, we developed an AI-powered Mediator involving two distinct perspectives:
- Freelancer Advocate: Represents the freelancer’s position using submitted work and supporting evidence.
- Client Advocate: Represents the client’s position using the original requirements and review findings.
These agents examine the disagreement, exchange arguments, and work toward a mutually acceptable settlement proposal.
The final decision remains with the client and freelancer. AI assists the negotiation; it does not autonomously control payments.
Once the client approves the completed milestone, the authorized PayPal payment can be captured and released to the freelancer.
How We Built It
We developed Settle as a full-stack application with an emphasis on integrating AI workflows with real payment infrastructure.
Technology stack:
- Frontend: React, modern responsive UI and reusable components.
- Backend: Node.js and Express.js.
- AI: Google Gemini-powered Scoper, Reviewer and Mediator agents.
- Code intelligence: GitHub API integration for repository inspection and evidence collection.
- Payments: PayPal Sandbox APIs for payment authorization, capture and void operations.
- Webhooks: PayPal webhook integration with signature verification for payment event processing.
- Deployment: Vercel for the frontend.
We designed the application around milestone-level payment states and structured acceptance criteria so that project progress, AI review results, and payment operations remain connected.
Challenges We Faced
Making AI evaluations evidence-based
One of our biggest challenges was moving beyond generic LLM responses. A model saying that a project is complete is not sufficient when money is involved.
We addressed this by structuring the review around individual acceptance criteria and integrating GitHub repository inspection to provide supporting evidence.
Designing balanced AI dispute resolution
A dispute involves two parties with potentially conflicting interests. A single AI-generated response could introduce bias.
We explored a multi-agent approach in which separate agents advocate for each party, examine the available evidence, and negotiate toward a settlement proposal.
Integrating payment authorization and capture
Implementing milestone-based payments required understanding the distinction between authorizing a payment, capturing it, and voiding an authorization.
We integrated PayPal Sandbox APIs and webhook signature verification to support these operations while keeping sensitive payment credentials on the backend.
Connecting asynchronous systems
AI reviews, GitHub API requests, payment operations, and webhook events do not necessarily complete at the same time.
Maintaining consistent application state across these operations required careful backend coordination, status handling, and error management.
What We Learned
Building Settle taught us that integrating AI into a real-world application requires much more than connecting an LLM API.
We gained practical experience in:
- Designing multi-agent AI workflows with different responsibilities.
- Building evidence-driven AI evaluation systems.
- Integrating third-party APIs and payment infrastructure.
- Implementing authorization, capture, void, and webhook verification.
- Managing asynchronous backend operations and application state.
- Designing human-in-the-loop systems for decisions involving money.
- Building a product around a real-world problem rather than starting with a technology and searching for a use case.
What’s Next?
We envision Settle evolving into a broader trust infrastructure for independent work, supporting different types of digital deliverables beyond software development.
Future possibilities include document verification, design deliverable evaluation, additional payment providers, improved dispute-resolution mechanisms, and deeper transaction auditing.
Our Vision
We believe the future of freelancing should not depend entirely on blind trust.
Settle aims to make every milestone measurable, every review evidence-based, and every payment more transparent.
Settle — Work Delivered. Payments Protected.
Built With
- gemini
- javascript
- next.js
- typescript
- vercel