Inspiration
In Senegal, small neighborhood shops are at the heart of daily life, yet many owners still run them with a notebook, a calculator and their memory. Stock runs out without warning, margins are guesswork, and nobody can say for sure which product really brings in the most money.
At the same time, digital payments are growing. Mobile Money is already part of everyday life, while Bitcoin and the Lightning Network are still little known. I wanted to build one tool that helps shop owners manage their business and also opens the door to new ways of getting paid.
What it does
SamaBoutik is an Android app for small shop owners. It covers four things.
Managing the shop. The owner creates an account, adds products with purchase price, selling price, quantities and stock status, and records restocking. A "My stock" screen shows the value of the stock, purchases over the last 30 days and the products to restock. When a product runs low or out, an alert appears with a direct link to restock it.
Turning sales into data. Every sale updates the stock and feeds the statistics. The owner can follow sales over 7 days, 30 days or 3 months, see a ranking of products by units sold, revenue or profitability, check profits, the average basket and the breakdown by payment method. An AI analysis uses real sales to give simple advice and show what to restock now. This lets a shop owner see which products sell the most and which ones actually earn the most, which are not always the same.
Getting paid. A sale can be paid in cash, by Mobile Money or card (through PayDunya, currently in test mode with no real money), or in Bitcoin over the Lightning Network. For Bitcoin, the merchant receives payments in an LNbits wallet managed by the backend, and the customer does not need any SamaBoutik account: they pay in sats with their own Lightning wallet.
- The merchant chooses Bitcoin payment for a sale.
- The backend asks LNbits for an invoice for the amount of the sale.
- The app shows a QR code, with the amount in FCFA and in sats, valid for 5 minutes.
- The customer scans it and pays from their own wallet.
- The backend checks the invoice status with LNbits.
- Once the payment is confirmed, the sale is updated in the app.
If the payment is not completed, the sale stays recorded as "Bitcoin unpaid" and the merchant can offer another payment method.
Learning. The app includes built-in explanations about Bitcoin and the Lightning Network (what Bitcoin is, what a wallet is, how to scan a QR code, how to know a payment is confirmed), because many merchants are discovering these tools for the first time.
How we built it
The mobile app is built with Flutter and Dart. The backend is a Laravel (PHP) API with a MySQL database. The backend talks to PayDunya for Mobile Money and card payments, and to the LNbits API to create Lightning invoices and check their status. The mobile app never talks to the payment services directly: everything goes through the backend.
On security:
- User accounts are protected by a password.
- Payments are handled on the server side, not in the mobile app.
- For Bitcoin, customers keep control of their funds with their own wallet, and SamaBoutik never holds their keys.
- Two-factor authentication and stronger protection of data and API keys are planned.
Challenges we ran into
- Bringing cash, Mobile Money and Bitcoin into a single sale flow, each with its own statuses (paid, unpaid, attempted again).
- Making Lightning payments dependable: an invoice expires after a few minutes, so the backend has to check its status and update the sale correctly.
- Explaining Bitcoin to people who have never used it, which led to the built-in educational content.
- Testing payment flows without real money, since the integrations run in test mode for now.
Accomplishments that we're proud of
- A working prototype that can be installed from a single APK file, with no setup needed to try it.
- A complete flow from creating a product to a confirmed Lightning payment, where the customer needs no account.
- Statistics that go beyond best sellers: products can be ranked by profitability, and the app shows profits and stock to reorder.
- An AI analysis built from real sales that turns the numbers into simple advice.
- Educational content that makes Bitcoin and Lightning easier to approach for first-time users.
What we learned
- How a Lightning payment works from start to finish, from invoice creation to confirmation through the LNbits API.
- How to connect a payment provider such as PayDunya and work with its test mode.
- That for non-technical users, clear screens and simple messages matter as much as the features themselves.
What's next for SamaBoutik
- Self-hosted Lightning server (LNbits).
- PayDunya in production, with real Mobile Money payments.
- Real withdrawals to Mobile Money.
- Push notifications for sales and stock alerts.
- Stronger security: two-factor authentication, API keys, hosting.
- Tests with local merchants to gather feedback.
- More advanced analysis, then demand forecasting.
Expected impact
I want small shop owners to put their notebook aside and run their shop from their phone, access new ways of getting paid, and discover Bitcoin through a concrete, everyday use. To measure the impact, I will track the number of merchants and active shops per week, frequency of use, sales recorded, stock-outs detected and avoided, digital payments (including Lightning) and time saved compared to manual management.
Try the app
- Download and install the APK. Allow installation from unknown sources if your phone asks.
- Create a merchant account and add a few products.
- Create a sale and choose a payment method.
- Bitcoin: scan the QR code with a Lightning wallet. Mobile Money: the PayDunya flow opens in test mode.
- Check the sales history, the product ranking, the statistics and the AI analysis.
Current limitations: Mobile Money and card payments are in test mode, the LNbits server is not yet self-hosted, the app is Android only, real FCFA withdrawals are not yet active, and an Internet connection is required.
Links
- Demo video: https://youtu.be/4pg53nRwz88
- Android app (APK): https://github.com/Faith-time/samaboutik-app/releases/download/v1.0.0/samaboutik.apk
- App source code (Flutter): https://github.com/Faith-time/samaboutik-app
- Backend source code (Laravel): https://github.com/Faith-time/samaboutik-api
Adji Fatime BÂ, project lead