About SettleMate
💡 Inspiration
Managing shared expenses with friends, roommates, or teammates often becomes unnecessarily complicated. Whether it is splitting a dinner bill, sharing travel expenses, or managing payments within a group, keeping track of who paid, who owes money, and how much everyone needs to contribute can quickly become confusing.
We wanted to solve this everyday problem by building something that makes group expense management simpler, more transparent, and less stressful.
That idea led to SettleMate — a group expense management and settlement platform designed to make splitting expenses and settling debts easier.
🚀 What We Built
SettleMate brings group expense tracking and settlement management together in one platform.
Users can:
- Create and manage groups: Organize shared expenses with friends, roommates, or other members.
- Track expenses: Record expenses, specify who paid, and select the participants involved.
- Split bills: Distribute expenses among group members.
- Monitor balances: Automatically calculate who owes money and who should receive it.
- Generate settlements: Suggest optimized transfers to simplify outstanding payments.
- Manage settlement status: Track settlement approvals and pending transfers.
- PayPal integration: Incorporate PayPal payment workflows to support the settlement process.
Our goal was to move beyond simply recording expenses and provide a complete workflow from spending to settlement.
🛠️ How We Built It
We developed SettleMate using a modern full-stack architecture.
Frontend
- Next.js
- React
- TypeScript
- CSS
Backend
- Python
- FastAPI
- SQLAlchemy
- Pydantic
Database
- PostgreSQL
- Alembic for database migrations
Payments
- PayPal Orders API integration
The frontend communicates with the FastAPI backend through REST APIs. The backend handles authentication, group management, expense records, balance calculations, and settlement workflows.
We focused on financial correctness by using integer minor units for monetary calculations rather than relying on floating-point arithmetic. This helps avoid rounding inaccuracies when splitting expenses.
📚 What We Learned
Building SettleMate taught us that a financial application involves much more than creating forms and displaying numbers.
We gained practical experience with:
- Designing and integrating a full-stack application.
- Building REST APIs with FastAPI.
- Managing relational data and database relationships.
- Implementing authentication and authorization.
- Handling financial calculations and expense-splitting logic.
- Designing settlement workflows.
- Integrating third-party payment infrastructure.
- Testing API endpoints and validating frontend-backend communication.
One of our biggest takeaways was the importance of financial accuracy, data consistency, and security when building applications that deal with money.
⚡ Challenges We Faced
One of the biggest challenges was ensuring that expense splits and balances remained mathematically consistent across multiple group members.
We also had to handle different settlement scenarios, including situations where multiple people owe money to different members of the same group.
Another challenge was integrating the frontend and backend while maintaining reliable authentication, database connectivity, and consistent API responses.
Payment integration introduced another layer of complexity. We had to distinguish between an approved settlement and an actually completed payment, ensuring that the application does not incorrectly report a transfer as successful before receiving provider confirmation.
Working through these challenges helped us understand the importance of reliability and correctness in financial software.
🌟 What's Next?
We envision SettleMate becoming a more comprehensive shared-finance platform, with improvements such as:
- More advanced settlement optimization.
- Verified end-to-end PayPal Sandbox payment flows.
- Better transaction history and reporting.
- Notifications and payment reminders.
- Enhanced group and expense analytics.
SettleMate is our attempt to make splitting expenses less awkward, tracking money more transparent, and settling up a whole lot easier.
Built With
- alembic
- css
- fastapi
- next.js
- paypal
- paypal-orders-api
- postgresql
- pydantic
- python
- react
- rest-api
- sqlalchemy
- typescript
- uvicorn