Avenue

Avenue is a production-oriented Wallet-as-a-Service platform built on top of Nomba’s payment infrastructure. The project was developed for the Nomba × DevCareer Hackathon 2026, with a focus on dedicated virtual accounts and the infrastructure required to reliably manage customer funds at scale.

The core idea behind Avenue is to abstract away the complexity that developers normally face when integrating payment infrastructure. Instead of every application having to independently manage virtual account provisioning, webhook processing, transaction reconciliation, ledger consistency, edge cases, and payment notifications, Avenue provides these capabilities through a unified API.

A major focus of the project is financial correctness and reliability. Incoming Nomba webhooks are processed idempotently using unique transaction references to prevent duplicate credits. Transactions are recorded using an immutable, ACID-compliant double-entry ledger, allowing balances and transaction history to remain auditable and consistent even under concurrent operations.

Avenue also introduces an AI-powered reconciliation pipeline for handling messy bank-transfer narrations. Incoming payment descriptions are processed through an LLM to extract transaction intent, confidence scores, flags, and suggested labels. High-confidence transactions can proceed automatically, while ambiguous or potentially misdirected payments are routed into a dedicated Suspense Engine for review rather than being incorrectly credited.

The platform supports automated account agents, including balance alerts and auto-sweep rules, allowing developers to attach business logic directly to wallets. It also provides signed outbound webhooks using HMAC-SHA256, retry mechanisms, API-key authentication, wallet management, transaction statements, analytics, webhook logs, and operational controls through an administrative dashboard.

From an architecture perspective, Avenue uses a FastAPI/Python backend, PostgreSQL with SQLAlchemy for persistent financial data, Redis and arq for asynchronous background processing, and Nomba for virtual accounts, transfers, and payment events. The frontend is built with Next.js, React, TypeScript, Tailwind CSS, Redux Toolkit, and RTK Query, providing an interface for managing wallets, transactions, suspense items, agents, webhooks, and API credentials.

The system was designed around several important financial-infrastructure principles: idempotency, immutable transaction history, atomic database operations, secure webhook verification, encrypted secrets, asynchronous processing, and controlled handling of uncertain transactions.

Overall, Avenue demonstrates how payment primitives can be transformed into a higher-level financial infrastructure product giving developers a reliable way to provision customer wallets, reconcile incoming payments intelligently, automate account behavior, and integrate financial functionality without rebuilding the underlying ledger and payment-processing systems themselves.