Who this guide is for
Developers integrating payments into a website, mobile app, or internal billing tool. No prior lomi. experience assumed — you need basic HTTP and environment variable comfort.
1. Create your account
Sign up at lomi.africa and create an organization. You start in sandbox mode with test credentials separated from production.
2. Enable payment methods
In the dashboard, open Payment channels and enable what your market needs: Wave, MTN MoMo, SPI, and/or cards. Sandbox simulates success and failure paths without moving real money.
3. Choose an integration path
Fastest: hosted checkout — create a checkout session via API or dashboard, redirect the buyer to the returned URL, handle the success redirect and webhook.
No backend yet: payment links from the dashboard or CLI for one-off charges.
Shopify: install our Shopify app and connect the store (see our Shopify blog post).
Custom UI: use the TypeScript SDK or REST API directly; embed components with lomi ui add from the CLI if you want prebuilt checkout widgets.
4. Create a checkout session (API)
POST /checkout/sessions with amount, currency (XOF), success_url, cancel_url, and line items. Authenticate with your secret key. The response includes a url field — send the customer there.
Example with CLI: lomi login, then lomi checkout create --amount 5000 --currency XOF after lomi init in your project directory.
5. Listen for webhooks
Register a webhook endpoint in the dashboard. Verify signatures on incoming events. checkout.session.completed is the event most integrations handle first — mark orders paid only after webhook confirmation, not on redirect alone.
Local dev: lomi listen http://localhost:3000/webhooks forwards sandbox events without ngrok.
6. Go live
Complete merchant verification, switch to production keys, run one small real transaction, and monitor the dashboard for settlement.
Full reference: docs.lomi.africa. Questions: hello@lomi.africa.
----
lomi. is a payment processing platform based in Côte d'Ivoire. We create and commercialise e-commerce products with built-in payment channels aggregation capabilities, facilitating digital payments and disbursements for merchants and businesses of all sizes. To learn more about what drives our product roadmap, read our blog, visit our GitHub, download our merchant mobile app, or simply create an account.