TrustFlow

AI-powered milestone verification and secure payments that build trust between freelancers and clients.

Comment

Inspiration

Freelancing offers flexibility, but it comes with a trust problem. Clients worry about paying for incomplete or unsatisfactory work, while freelancers worry about completing projects without receiving payment. Miscommunication around expectations and deliverables makes things even harder.

We wanted to build a platform that makes freelance collaborations more transparent, accountable, and trustworthy.

What it does

TrustFlow is an AI-powered milestone verification and payment coordination platform designed for freelancers and clients.

  • Clients create projects with clearly defined milestones, deliverables, deadlines, and payment amounts.
  • Freelancers submit their completed work along with supporting evidence.
  • Gemini AI evaluates submitted evidence against the agreed milestone criteria and identifies completed requirements, gaps, and areas needing improvement.
  • Clients review the assessment and retain full control over milestone approval.
  • PayPal integration supports payment authorization and capture following client approval.
  • An activity timeline helps both parties track project progress and important decisions.

TrustFlow brings clarity to the relationship between work delivered and payments made.

How we built it

We built TrustFlow using a full-stack architecture:

  • Frontend: React, TypeScript, and Vite for the user interface.
  • Backend: Python and FastAPI for APIs, business logic, and payment workflows.
  • Database: PostgreSQL hosted on Neon for users, projects, milestones, evidence, payments, and activity records.
  • AI: Google Gemini API for evaluating milestone evidence against client-defined acceptance criteria.
  • Payments: PayPal REST APIs for payment order creation, authorization, and capture.
  • Deployment: Render for hosting the application.

We designed the AI assessment system to assist decision-making rather than replace human judgment. Final milestone approval remains with the client.

Challenges we ran into

One of our biggest challenges was designing an AI assessment system that could evaluate different types of freelance deliverables rather than focusing on just software development.

Integrating AI assessments with milestone states and payment workflows also required careful coordination.

PayPal integration presented another challenge, particularly around Sandbox configuration, payment authorization, capture, and handling different payment states.

We also had to consider security: ensuring that only authorized clients could approve milestones and trigger payment capture.

Accomplishments that we're proud of

  • Built a platform that connects AI-powered work verification with milestone-based payment coordination.
  • Developed a flexible assessment workflow based on client-defined acceptance criteria.
  • Enabled evidence-based AI assessments with explanations and identified gaps.
  • Designed a human-in-the-loop approval process that keeps clients in control.
  • Integrated PayPal payment authorization and capture into the milestone lifecycle.
  • Created a shared workflow that improves transparency between freelancers and clients.

Most importantly, we brought together AI, accountability, and payment coordination into one unified experience.

What we learned

We learned that building an AI-powered product involves much more than connecting an API to a language model.

AI assessments need structured outputs, evidence-based reasoning, and clear limitations. Human oversight is essential when AI results influence financial decisions.

We also learned how important payment lifecycle management, backend validation, database consistency, and secure API integrations are when building financial applications.

What's next for TrustFlow

We envision expanding TrustFlow into a more comprehensive freelance collaboration and payment platform.

Our next priorities include:

  • Supporting more types of freelance deliverables and evidence formats.
  • Improving AI assessment accuracy and evidence traceability.
  • Introducing richer project analytics and milestone tracking.
  • Expanding payment capabilities and exploring PayPal marketplace integration for direct freelancer payouts.
  • Adding automated notifications and deadline reminders.
  • Strengthening dispute resolution and revision workflows.

Our long-term goal is to make TrustFlow a platform where clients can confidently approve work and freelancers can build stronger professional relationships through transparency and trust.

Share this project:

Updates

Submission history