Inspiration

I'm a former electrician from Karnataka, India, now learning to earn online as a freelancer. Millions of Indian freelancers work for clients abroad, but many of us are not comfortable writing professional English invoices — and when a client forgets to pay, we wait for weeks and feel awkward chasing them. I built KaamPay for people like me.

What it does

  1. The freelancer types the job in their own language (Tamil, Hindi, English or mixed), e.g. "லோகோ டிசைன், 3 revision, $50".
  2. Gemini AI turns it into clean, professional English invoice items, plus a short Tamil summary so the freelancer can confirm it is right.
  3. The freelancer reviews it — nothing is sent without their approval.
  4. KaamPay creates and sends a real invoice through the PayPal Invoicing API; the client gets a secure PayPal payment link by email.
  5. The agent checks the invoice status with PayPal every 30 seconds. If the client hasn't paid, it sends one polite reminder through PayPal automatically.
  6. When the client pays, the status changes to PAID and the full timeline is shown.

How I built it

  • Node.js + Express backend
  • Google Gemini API for understanding mixed-language job notes and returning structured JSON
  • PayPal REST APIs (Sandbox): OAuth 2.0, Invoicing v2 — generate invoice number, create, send, get status, remind
  • A simple agent loop that watches open invoices and decides when to send a reminder
  • Plain HTML/CSS/JS frontend

Challenges

  • PayPal does not allow sending invoices to customers inside India. This shaped the product: KaamPay is designed for Indian freelancers with international clients.
  • The Gemini free tier was sometimes busy or hit its daily limit, so I added automatic retries and fallback models.
  • I am not a trained developer and English is not my first language — I learned step by step with AI assistance.

Accomplishments

A complete, working loop: local-language note → AI invoice → PayPal invoice → automatic reminder → PAID, with the human always in control before anything is sent.

What I learned

How OAuth and REST APIs work, how PayPal invoicing and sandbox testing work, and how to design an agent that helps without taking control away from the user.

What's next

WhatsApp and voice input, more Indian languages, multiple reminder schedules, and moving from Sandbox to live payments.

Built With

Share this project:

Updates

Submission history