-
-
Edit and approve personalized email drafts before sending.
-
Discover target companies and track buyers, qualified leads, and outreach readiness.
-
Review buyer classifications, scores, contact verification, and outreach status.
-
A confirmed $20 PayPal Sandbox payment, tracked automatically in Revenue.
-
Qualifyr — from buyer discovery to human-approved outreach and PayPal payments
Inspiration
Small businesses often manage prospect research, outreach, proposals, and payments across disconnected tools. Finding a company is only the beginning: someone still needs to assess its relevance, locate a usable contact, prepare a message, agree on terms, and confirm payment.
We built Qualifyr to connect these steps while keeping business owners in control of outreach and commercial decisions.
Project background and hackathon additions
I began developing Qualifyr before this hackathon. The existing application supported company discovery, buyer classification, contact enrichment, lead scoring, and human-reviewed outreach.
During the hackathon submission period, I extended the project with PayPal Sandbox proposal and payment workflows: human-approved commercial terms, invoice and one-time checkout creation, server-side payment verification, webhook handling, and Revenue tracking for confirmed payments.
I also added requalification of saved leads, improved campaign execution feedback, fixed checkout and revenue consistency issues, and deployed the frontend and backend on Render.
This submission builds on my existing project; the full application was not created entirely during the hackathon.
What it does
Qualifyr turns a campaign into a guided workflow:
- Discover: Describe an offer and target market to find potential customer companies.
- Qualify: Inspect buyer classifications, scores, contact details, and supporting evidence.
- Review outreach: Edit and approve email drafts before sending. Dry runs allow testing without contacting prospects.
- Prepare a proposal: Review evidence-based proposal text and explicitly approve pricing and terms.
- Collect payment: Generate a PayPal Sandbox checkout link for the buyer.
- Track revenue: Display payments only after the backend confirms them with PayPal.
Optional AI providers assist with keyword generation, relevance assessment, and grounded text generation. Free discovery and deterministic fallbacks keep the core workflow usable without paid AI keys.
How we built it
The frontend uses Next.js, React, TypeScript, and Tailwind CSS, with a Python FastAPI backend. Firebase handles authentication, PostgreSQL stores application data, and GitHub Actions runs longer discovery jobs. The frontend and API are deployed on Render.
The PayPal integration uses Sandbox OAuth authentication, Orders v2 checkout and capture, Invoicing v2, and webhook signature verification. Payment status is verified on the server rather than inferred from a browser redirect.
OpenAI Codex assisted with implementation, debugging, testing, and deployment preparation.
Challenges we faced
Reliable background jobs: Discovery runs outside the web request, so the interface needed clear running states, failure reporting, and protection against duplicate starts.
Useful qualification: A company being classified as a buyer does not automatically make it ready for outreach. We separated classification, score thresholds, contact readiness, and suppression rules, and added requalification of saved leads.
Payment consistency: Buyer approval and confirmed payment are different events. We implemented server-side verification and updated Revenue to include confirmed one-time checkouts alongside invoices.
Deployment: Moving from local development to separate hosted services required careful configuration of authentication, API routing, callback URLs, and webhooks.
What we learned
A useful sales workflow needs more than generated text. It needs evidence, understandable status changes, explicit approvals, and reliable payment verification.
We also learned to make optional AI features degrade gracefully and to treat background processing and payment callbacks as essential parts of the user experience.
Accomplishments we're proud of
- Connected discovery, qualification, outreach review, proposals, and payment tracking.
- Preserved human approval before sending outreach or accepting proposal terms.
- Completed a $20 PayPal Sandbox checkout and displayed the confirmed payment in Revenue.
- Demonstrated the functioning desktop web application in under three minutes.
- Published the source code under GPLv3.
All demonstrated payments use PayPal Sandbox. No real money is transferred.
What's next
We plan to improve contact enrichment, explain outreach eligibility more clearly, expand campaign controls, and strengthen operational monitoring for discovery jobs and payment events.
Links
Built With
- fastapi
- firebase
- gemini
- github
- groq
- next.js
- ollama
- openai
- paypal
- postgresql
- python
- react
- render
- tailwind
- typescript