lomi.

Helping West African ventures sell online

Discord · Issues

Website   •   Docs   •   API   •   Blog

---

About lomi.

lomi. is a unified payment orchestration platform that integrates multiple payment service providers and provides a seamless experience for merchants and their customers across West Africa and beyond. Our platform simplifies product and subscriptions billing while ensuring the highest levels of security, reliability, and compliance.

Open Source Roadmap

We are progressively open-sourcing the entire lomi. project:

• Currently Open Source:

  • Merchant dashboard : apps/website
  • Documentation website: apps/developers

• Opening Soon:

  • API service: apps/api
  • Boilerplate Next.js + Medusa: apps/store
  • Boilerplate Vite + Medusa: apps/commerce
  • Shopify extension: apps/shopify
  • CLI tool: apps/cli
  • Jumbo (Online IDE) apps/jumbo

Everything will be made available in the coming weeks and all separate repositories will be merged in the monorepo.

Features

🔌 Multiple Payment Providers
Seamlessly integrate with various payment providers (Wave, MTN, Orange Money, Stripe) through a single API.

🎨 Customizable Checkout
Create beautiful, branded checkout experiences that work across all devices.

🎨 Recurrent Payment Processing
Automate subscription payments and recurring invoices with seamless support for mobile money (WhatsApp) and card payments via email.

👤 End-Customer Portal
Provide customers with a self-service portal to manage their payment methods, view transaction history, request refunds, update subscription and account details.

📊 Comprehensive Analytics
Gain valuable insights into your customers payment behavior, conversion rates, and payment trends.

🛡️ Fraud Detection
Advanced fraud prevention tools to protect your business and customers.

🔔 Webhook Management
Real-time notifications for payment events to keep your systems in sync.

🔒 Secure Tokenization
Safely store customers payment details for future transactions without handling sensitive data.

👥 Role-Based Access Control
Manage team permissions with granular control over who can access what.

🏦 Instant Payouts for Merchants
Enable businesses to access their funds instantly via mobile money or bank withdrawals.

Core Infrastructure

• TypeScript
• Node.js/Bun
• Vite
• Nextjs
• Remix
• React
• Shadcn UI
• Radix UI
• PostgreSQL via Supabase
• Resend
• Upstash
• Anthropic
• Huggingface
• Infobip
• Tailwind CSS
• Mixpanel
• Sanity

Payment Service Providers (PSPs)

• Wave
• Orange
• Crypto via NP
• MTN (upcoming)
• Stripe CNT (upcoming)
• Airtel Money (upcoming)
• More integration coming soon!

Quick Start

Local development (via merchant dashboard)

# Clone the repository
git clone https://github.com/lomiafrica/website.git

# Install dependencies
bun install

# Set up environment variables
cp .env.example .env

# Start the development server
bun run dev

Documentation

For comprehensive documentation, visit developers.lomi.africa

Use Cases

• E-commerce: Sell physical or digital products online through your website or platforms like Shopify or WooCommerce. Transactions are typically one-time purchases.
• SaaS (Software as a Service): Offer software on a subscription basis, with automated recurring billing for continuous access.
• Subscription services: Manage recurring payments for memberships, content access, and digital products.
• Marketplaces: Handle multi-vendor transactions for platforms like Yango.
• Crowdfunding & Donations: Process payments for fundraising platforms, nonprofits, and charities.
• On-Demand Services: Enable instant payments for ride-sharing, food delivery, and freelance platforms.
• B2B Payments: Support invoicing, large transactions, and business-to-business billing.
• Financial Services & Fintech: Power embedded finance, payouts, and banking-as-a-service solutions.
• Education & Online Learning: Collect payments for courses, e-learning platforms, and certifications.
• Events & Ticketing: Sell tickets for concerts, conferences, and online events.

License

This project is dual-licensed:

1. The majority of the codebase is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means you can freely use, modify, and distribute this code while ensuring that any modifications you make are also open source.

2. Certain files marked with /* @proprietary license */ are under lomi.africa's LLC Commercial License. These files require a valid commercial license from lomi. for production use.

See the LICENSE file for the complete terms of both licenses.

Contributing

We welcome contributions to lomi. ! This document outlines how to submit changes and which conventions to follow.

Prerequisites

• You're familiar with GitHub Issues and Pull Requests
• You've read the documentation
• You've already set up your local instance with git clone https://github.com/lomiafrica/website or via bun install lomi.cli

Contribution process

1. Issues First: Before working on a change, make sure there's an issue for it. Find an existing issue or open a new one.

2. Fork & Branch: Fork the repository and create a branch from develop with a descriptive prefix:

   • fix/ for bug fixes
   • feat/ for features
   • docs/ for documentation changes

3. Make Changes: Keep your commits small and focused and ensure that your contribution doesn't modify files marked with `/* @proprietary license *

4. Submit PR: Open a pull request against the develop branch. Include a clear description following the What-Why-How-Testing structure.

5. Code Review: A team member will review your PR within a few hours/days.

For detailed contribution guidelines, please see our CONTRIBUTING.md.

Community & Support

• Discord: Join our community Discord for discussions and help
• Twitter: Follow @lomiafrica for updates
• GitHub: Submit issues for bug reports and feature requests
• Email: Contact hello@lomi.africa for direct support

Security

• For security vulnerabilities, please follow our Security Policy
• Kindly do not report security vulnerabilities through public GitHub issues