Kassolightning

🧠 Inspiration

In Senegal, small merchants and street vendors rely heavily on cash, which limits access to digital payments and financial tools. While UPI revolutionized microtransactions in India, there’s still no smooth, low-fee, open digital payment system widely available in West Africa. Bitcoin’s Lightning Network provides the foundation to fix this — instant, borderless payments without banks or intermediaries. KassoLightning was built to bring a UPI-like Lightning experience to Senegalese merchants and users.

⚡ What it does

KassoLightning is a Lightning-powered merchant app that enables small businesses to accept Bitcoin payments instantly through scannable QR codes — just like UPI in India, but built entirely on the Bitcoin Lightning Testnet.

Merchants can generate Lightning invoices.

Users can scan and pay using Alby or BlueWallet testnet wallets.

Each transaction is securely logged in Firebase for visibility.

The dashboard shows live payment history, balances, and transaction details.

It’s minimal, fast, and designed for real-world, low-bandwidth environments.

🏗️ How we built it

Frontend: React + Vite for a blazing-fast UI with clean CSS animations.

Backend: Node.js (Express) server integrated with the Alby Lightning Testnet API for invoice generation and payment verification.

Database: Firebase Realtime Database to store and fetch transaction records securely.

Bitcoin Layer: Alby Hub testnet for Lightning operations and test BTC payments.

Architecture: Modular RESTful API structure with environment-based configuration for easy deployment and scalability.

We kept it lightweight so anyone can deploy it locally or on cloud within minutes.

⚙️ Challenges we ran into

Integrating Lightning Testnet APIs with real-time payment updates.

Ensuring the system remained stable despite API rate limits on testnet nodes.

Handling QR generation, invoice expiry, and smooth UI feedback for payments.

Limited testnet liquidity while testing large payment flows.

Designing a UX that feels like UPI but works on Bitcoin rails.

🏆 Accomplishments that we're proud of

Achieved a working end-to-end payment flow between testnet Lightning wallets and our merchant web app.

Built a clean, mobile-friendly UI suitable for local small business usage.

Used Firebase + Lightning combo for a fully serverless, low-maintenance MVP.

Brought the concept of “Bitcoin UPI” to life for the first time in the Senegalese context.

📚 What we learned

How to work with Bitcoin Lightning APIs and understand channel/liquidity mechanics.

Best practices for secure invoice handling and payment verification.

Designing for low-network environments where simplicity matters more than complexity.

How open-source Bitcoin tools like Alby and LNbits can empower local economies.

🚀 What's next for KassoLightning

Move from Testnet → Mainnet to support real Bitcoin payments.

Add offline QR caching for rural vendors.

Build multi-language support (Wolof, French, English).

Enable SMS-based payment verification for feature phones.

Partner with Senegalese businesses to pilot live adoption in marketplac

Built With

• javascript
• react