E‑commerce
Official and maintained plugins for hosted checkout with lomi.. WooCommerce, Magento 2, PrestaShop, and Shopify use the same public API contract for checkout sessions and merchant webhooks.
E‑commerce
Install lomi. on your store without writing checkout plumbing yourself. These modules create hosted checkout sessions, redirect shoppers to lomi. Checkout, then confirm payment via return URLs and merchant webhooks.
Shared technical contract
WooCommerce, Magento 2, and PrestaShop talk only to lomi.’s public REST API (/v1/checkout-sessions). They do not call Supabase RPC or internal-only Nest endpoints.
| Concern | Contract |
|---|---|
| Base URL | https://api.lomi.africa (live) or https://sandbox.api.lomi.africa (test) |
| Auth | X-API-Key, merchant secret key from the dashboard |
| Create session | POST /checkout-sessions |
| Confirm session | GET /checkout-sessions/{id} |
| Paid state | Session status completed, with amount/currency checked against the cart/order |
| Webhooks | X-Lomi-Event (e.g. PAYMENT_SUCCEEDED), X-Lomi-Signature, HMAC-SHA256 hex over the raw JSON body |
For the canonical wording maintained next to source code, see:
- Shared technical contract (this page)
- Verify payments and Handling webhooks
Before going live, also read API integration, Authentication, and Webhooks for outbound subscription management.
Where to get each plugin
| Platform | Install artifact |
|---|---|
| WooCommerce | Download from docs (woo-lomi.zip), step-by-step setup with screenshots |
| Magento 2 | Composer VCS from magento or copy to app/code/Lomi/Payments/ |
| PrestaShop | Zip the lomi/ folder from prestashop |
| Shopify | Dashboard → Settings → Payment channels → Integrations (custom install, no zip) |
| Bubble | Bubble editor → Plugins → Add plugins → lomi. (or GitHub sync), step-by-step setup |
Choose your platform
WooCommerce
WordPress / WooCommerce payment gateway
Magento 2
Lomi_Payments hosted checkout module
PrestaShop
PrestaShop 1.7+ module
Shopify
Custom app, cart pay with mobile money and cards
Bubble
No-code Bubble.io plugin, redirect or embedded checkout
Shopify is distributed as a custom install app (not App Store payments). Enable it from dashboard.lomi.africa → Settings → Payment channels → Integrations, then install on your store via OAuth.
Other ways to integrate
Not on a supported platform, or building a custom flow? These give you the same hosted checkout without a store plugin:
- Embed widget, a drop-in checkout button and modal for any site (including Bubble and custom HTML).
- Hosted checkout, the lomi. page your plugins redirect shoppers to.
- Storefront, merchant product pages and subscribe flows (
display_on_storefronton catalog products). - lomi-ui, copy-paste checkout components when you want your own UI.
- CLI, create and test checkout sessions from your terminal.
- MCP, drive checkout from AI agents and IDE workflows.
Plugin, embed, or API?
| You want to… | Use |
|---|---|
| Add payments to a supported store (Woo, Magento, PrestaShop, Shopify, Bubble) | The plugin for that platform |
| Add a checkout button to a custom site or no-code page | Embed widget |
| Keep your own checkout UI but skip the payment plumbing | lomi-ui components |
| Full control from your own backend | The public API (POST /checkout-sessions) |
| Sell from a hosted product catalog (no store plugin) | Storefront with Products (display_on_storefront) |
| Automate or test from a terminal or AI agents | CLI or MCP |