lomi. Plugins Monorepo

Welcome to the central repository for lomi. payment plugins.

This repository is the entry point for e-commerce integrations (WooCommerce, PrestaShop, Magento, Shopify, etc.) and reference apps that demonstrate the lomi. API.

Repository layout

Platform plugins (Git submodules)

Each directory is a submodule pointing at its own repository:

Directory	Platform	Submodule repo	Access
woo	WooCommerce	lomiafrica/woo	Public
prestashop	PrestaShop	lomiafrica/prestashop	Public
magento	Adobe Commerce (Magento 2)	lomiafrica/magento	Public
shopify	Shopify	lomiafrica/shopify	Private (org access required)
bubble	Bubble.io	lomiafrica/bubble	Private (org access required)
odoo	Odoo ERP	lomiafrica/odoo	Private (org access required)

Integration references (in this repo)

These live at the repository root (not submodules). Use them as copy-paste examples for merchants and partners:

• direct-charge-integration-reference: Direct charges (POST /charge/*) with Payment Elements for cards.
• lomi-edupay-connector: EduPay (Yele Group) partner connector — direct charges for school fees.
• payment-integration-reference: Hosted checkout sessions via the raw HTTP API.
• payment-integration-sdk-reference: Hosted checkout sessions with @lomi./sdk and @lomi./embed.

Installation and cloning

Use --recursive when cloning so submodule checkouts are initialized:

git clone --recursive https://github.com/lomiafrica/plugins.git
cd plugins

If you already cloned without submodules:

git submodule update --init --recursive

If a submodule fails with "repository not found", that platform repo is private — request access from the lomi. team. WooCommerce, PrestaShop, and Magento submodules are public.

End-to-end tests and scripts

• DEV-ENV.md: Local dev setup (Docker, Cloudflare Tunnel, sandbox keys) — start here for new contributors.
• E2E.md: Manual smoke matrix per platform (checkout, webhooks, abandon flows, release tags).
• scripts/run-plugin-tests.sh: Automated CI suite — static parity, webhook contract, Bubble JSON, Woo build + release zip.
• scripts/verify-lomi-plugins.sh: Static compliance gate (also run as step 1 of run-plugin-tests.sh).
• scripts/scan_broken_images.py: Scans Magento, PrestaShop, and Woo trees for broken image path references.

Run the full automated suite from the repository root (requires Node 22+, pnpm 9+, unzip):

./scripts/run-plugin-tests.sh

Static checks only (no Woo pnpm build):

./scripts/run-plugin-tests.sh --fast

Contributing

Pull requests and issue reports are welcome.

• Platform plugin changes: work inside the relevant submodule, push to that submodule's repo, then update the submodule pointer here if needed.
• Reference app or shared script changes: edit files directly in this repository (direct-charge-integration-reference, payment-integration-reference, payment-integration-sdk-reference, scripts/, E2E.md).
• Run ./scripts/run-plugin-tests.sh before opening a PR (--fast if Woo assets are unchanged).

License

Licensing is per platform. Check each submodule's README and license files (for example, Magento includes a root LICENSE). Reference projects in this repo follow the license stated in their respective directories.