Inspiration
Teens break things: cracked phone screens, bike wheels, borrowed laptops. Families usually handle it with an awkward conversation and a surprise bill. We wanted a way for teens to build their own safety net from their allowance, learn how protection works, and still keep parents in charge of every dollar. Paraguas means "umbrella" in Spanish: something you set aside for the day it rains.
What it does
Fund: a parent sends a one-time PayPal top-up or sets up a weekly PayPal subscription allowance. • Split: each confirmed payment is divided automatically between the teen's spending money and the family's umbrella fund. • Save: four weeks of steady jar contributions can unlock a parent-funded savings match. • Claim: when something breaks, the teen describes what happened and uploads a photo. • Review: Gemini checks the claim and photo against the family's own rules, estimates the repair cost, flags concerns, and writes a summary for the parent plus a friendly note for the teen. • Decide and pay: the parent approves or declines. On approval, PayPal Payouts pays the repair shop or the parent. • Coach: a Gemini money coach answers teens' questions about their balances and claims, and a parent assistant reads family balances, recent PayPal transactions and subscription status.
How we built it
Next.js 16 and React 19 on Vercel, with server-side API routes for every money action. • Neon PostgreSQL for family accounts, a double-entry style ledger, claims, payment state and idempotency keys. • Vercel Blob (private) for claim photos, streamed only through authenticated, ownership-checked routes. • Google Gemini through the AI SDK for multimodal claim review and role-aware chat with tools that read the ledger directly. • PayPal REST APIs: Orders for top-ups, Subscriptions for weekly allowances, Payouts for approved claims, transaction reporting, and webhook signature verification.
Challenges we ran into
Trust boundaries: an AI should never be able to move money. Gemini only advises. Deductibles, payout caps and available balance are enforced in server code, and every payout needs a parent's approval. • Payment integrity: a subscription redirect doesn't prove payment, so allowances are credited only after a verified PAYMENT.SALE.COMPLETED webhook, with exact-amount checks and idempotency to stop double credits or double payouts. • Multi-family separation: we rebuilt login so every parent registers their own family with a family code, and teens sign in with a parent-set PIN. Each family's ledger, claims and AI data stay fully separate. • AI reliability: chat replies sometimes timed out under load. We added per-attempt and total time limits, a chain of fallback Gemini models, and a ledger tool so balance answers come straight from the database.
Accomplishments that we're proud of
A complete loop from allowance to protection to claim to payout, built on real PayPal sandbox flows. • An AI reviewer that explains its reasoning to both parent and teen without ever having the power to pay. • Production-minded safety: signed sessions, rate limits, private photo storage, verified webhooks and reconcilable payout states.
What we learned
The best place for AI in fintech is judgment and explanation, not authority. Hard limits belong in code. • Webhooks, idempotency and exact-amount checks matter more than any UI when real money moves. • Teens engage more with money when the conversation is about something they care about, like their own phone.
What's next for Paraguas
Repair-shop partners who can receive PayPal payouts directly with itemized quotes. • Savings goals and streaks that grow the umbrella fund into a first real savings habit. • Shared rules templates for different family styles and age groups. • A move from PayPal Sandbox to live payments after a full security review.