-
-
Eter AI Copilot Conversational financial assistant for live FX, travel budgets, and safe PayPal checkout.
-
Digital Wallet : A multi-currency balance hub displaying operating funds, and more across 9 reserve currencies.
-
FD Loans & Credit : A credit line manager letting users borrow liquidity against locked Fixed Deposits.
-
Anywhere Hub Terminal : A cross-border routing terminal that finds the lowest fee and fastest clearing path across 200+ global territories.
-
Global Payments & FX : Clearing Network monitor tracking settlement speeds and benchmark currency pairs.
-
Transaction History (AG Grid) : Fast audit ledger with sorting, column filters, and one-click CSV export.
-
Payment Requests : Create and manage custom payment requests with email notifications and notes.
-
Payment Links : Create and share direct payment links with instant PayPal checkout support.
-
QR Payments : Personal and merchant QR generator for quick cross-border and local transfers.
-
Merchant & Business : Suite Business hub with live billing stats, invoice creator, and virtual soundbox.
-
Currency & Foreign Exchange : Live ECB interbank exchange rate calculator with zero hidden markups.
-
Invest & Portfolio Allocation : Simulated multi-asset wealth tracker and automated AI rebalancing simulator.
-
Travel & Global Gear (Commerce) : Multi-currency product catalog with instant checkout via PayPal Sandbox.
-
Travel & International Reservations : AI travel budget planner with anti-DCC protection against foreign ATM markups.
Inspiration
Managing money across borders today is surprisingly frustrating. Whether you are a student paying overseas tuition, a freelancer billing international clients, or someone traveling on vacation, you deal with the same three problems:
- Sneaky FX markups: Most traditional banks and payment platforms advertise "zero commission" but quietly add a 3% to 7% spread on the exchange rate.
- Scattered tools: You use one app to calculate currency rates, another to track budgets, another to send money, and spreadsheets to keep track of it all.
- Passive financial dashboards: Regular banking apps only tell you what you already spent yesterday. None of them proactively tell you if rates are in your favor today or how to plan your upcoming trip's daily cash burn.
We wanted to build EterPay to show that financial software can be both proactive and safe. We wanted a unified platform where an intelligent AI helper handles research, rate calculations, and travel budgeting, while a trusted, battle-tested system like PayPal handles every real dollar with strict human approval.
What it does
EterPay is an all-in-one multi-currency payment platform and financial assistant built around five core capabilities:
1. Multi-Currency Global Wallet
- Holds and tracks balances across 9 major currencies (
USD,EUR,GBP,INR,JPY,SGD,AED,CAD,AUD). - Rates update live from the European Central Bank (ECB) with zero hidden markups, showing you real interbank pricing.
- Switch active currencies in one click to see your entire net balance instantly re-denominated.
2. Conversational Financial Copilot (Eter AI)
Eter AI isn't just an open-ended chatbot—it connects directly to 8 verified financial tools:
convert_currency: Performs live, accurate conversions with timestamped rates.travel_budget_plan: Breaks down estimated food, transit, stay, and daily buffer costs across popular travel corridors (like US to Japan, India to Europe, etc.).search_commerce: Searches an international product catalog and displays prices in your preferred currency.filter_transactions_grid: Lets you talk to your ledger (e.g., "show me food expenses over $50") and automatically filters the table.audit_subscriptions: Spots recurring monthly charges and highlights unused leaks.propose_payment: Generates a pre-filled, validated payment slip ready for checkout.
3. Integrated PayPal Checkout
- When you buy products or send funds, EterPay initiates a server-side PayPal order.
- The checkout modal opens cleanly inside PayPal's secure sandbox environment. You review the exact amount, select your payment method, and confirm.
4. High-Speed Audit Ledger (AG Grid)
- Every transaction, conversion, and refund is logged with an immutable audit trail.
- Built using AG Grid Community v32, featuring instant client-side searching, column filters, and one-click CSV compliance export.
5. ReserveLien™ Collateral Credit Engine
- Instead of breaking a Fixed Deposit (FD) and paying early-withdrawal penalties when you need urgent cash, users can borrow against their savings.
- The engine calculates the effective net borrowing cost: $$\text{Net Spread} = \text{Borrowing Rate} - \text{Deposit Yield}$$ For example, borrowing at $8.45\%$ while earning $7.20\%$ yield means your actual borrowing cost is only: $$\text{Effective Net Cost} = 8.45\% - 7.20\% = 1.25\% \text{ p.a.}$$
- Protected by a strict $85\%$ Loan-to-Value (LTV) ceiling and a 2FA PIN confirmation gate before release.
How we built it
We designed EterPay with a modern, decoupled architecture:
Frontend Architecture
- Next.js 15.5 (React 19 App Router) written in TypeScript 5.6.
- Tailwind CSS 3.4 for a clean, accessible layout designed for dark and light modes.
@paypal/react-paypal-jsv8.8 to safely render the PayPal checkout buttons and handle client approval callbacks without ever seeing raw credit card numbers.- AG Grid Community v32.3 (
@ag-grid-community/client-side-row-model) for tabular financial telemetry and CSV exports.
Backend & AI Architecture
- FastAPI 0.115 on Python 3.11 with asynchronous route handlers and strict Pydantic v2 data models.
- Dual-Model AI Fallback:
- Primary: Google Gemini 1.5 Flash via
google-generativeaifor structured tool and function calling. - Secondary: Groq Cloud running Llama 3.3 70B Versatile for high-speed fallback if Gemini hits rate limits.
- Tertiary: Local deterministic rule-based engine if external networks are completely offline.
- Primary: Google Gemini 1.5 Flash via
- Market Data Feed: Real-time ECB rates pulled via the Frankfurter API.
- Database: SQLite with
aiosqliteand SQLAlchemy Async.
Dual-Cloud Deployment
- Frontend: Hosted on Netlify with edge SSR caching (
https://eterpay.runs-on.dev). - Backend: Hosted on Render in Oregon, US (
https://eterpay.onrender.com). - Testing: 35 automated backend tests using
pytestandpytest-asyncio.
Challenges we ran into
1. The "AI and Money" Safety Boundary
The biggest challenge was ensuring the AI model could never accidentally trigger a debit or manipulate user balances. We solved this by creating a Deterministic Payment Gate:
- The AI model only has permission to generate a structured
propose_paymentschema. - The backend validates the parameters against hard spending thresholds (
MAX_SINGLE_ORDER_USD = $300.00). - The actual money movement only happens when a human opens the PayPal modal and clicks "Pay Now".
2. Idempotency & Avoiding Double-Debits
If a user has a spotty network connection and clicks checkout twice, a bad payment system might charge them twice. We eliminated this by generating a unique UUID v4 PayPal-Request-Id for every order request, allowing safe automatic retries without duplicate payments.
3. Bridging Conversational AI to AG Grid
Users wanted to type commands like "show transactions from last week over $100" in chat and have the table update. Getting the LLM to output exact AG Grid filter model JSON structures required building a custom tool schema that translates natural language intents into column-specific filter terms.
4. Cross-Border Currency Harmonization
PayPal accounts operate in specific settlement currencies (like USD or EUR). If a user wanted to buy an item priced in INR, we had to dynamically convert the cart amount using live ECB interbank rates on the backend before generating the PayPal order, ensuring the exact value matched across both systems down to the cent.
Accomplishments that we're proud of
- Production-grade polish: Built a complete, responsive app with 40+ static and dynamic routes that runs live with zero console warnings.
- Zero-trust payment safety: Successfully created an AI finance copilot that is truly useful without compromising security—not a single payment can be made without explicit human confirmation in PayPal's modal.
- Multi-tier resilience: If the primary AI API drops or gets rate-limited, EterPay switches to Groq Llama 3.3 in less than 300ms without the user ever noticing a hiccup.
- Lightning-fast ledger: AG Grid easily filters, sorts, and exports thousands of simulated ledger entries instantly, giving the app an institutional feel.
- Realistic sandbox experience: Added a 1-click Quick Demo login system so judges and testers can explore both Personal and Merchant accounts immediately without creating test credentials from scratch.
What we learned
- PayPal SDK integration: Working with
@paypal/react-paypal-jsshowed us how simple it is to reduce PCI-DSS compliance scope by letting PayPal's hosted modal securely collect payment info. - Reliable AI function calling: We learned that giving an LLM strict Pydantic schemas and small, focused tools produces far better and safer results than asking one big prompt to do everything.
- Asynchronous Python performance: Using FastAPI with
httpxallowed us to query live exchange rate APIs, run database operations, and communicate with PayPal's endpoints concurrently with minimal latency.
What's next for EterPay
- PayPal Vault Integration: Add recurring subscription management through PayPal Vault so users can pause or cancel recurring services directly through Eter AI.
- Real-Time WebSockets: Replace polling with a live WebSocket feed for sub-second currency fluctuation alerts on high-volatility pairs.
- Multi-Party Split Payments: Introduce smart milestone escrows for cross-border freelance teams (e.g., automatically distributing project payouts among designers and engineers upon approval).
- Biometric Passkeys (WebAuthn): Add fingerprint and FaceID authorization as an extra layer before opening checkout modals on high-value transfers.
