PrestaShop

Module in the lomiafrica/prestashop repository under lomi/: hosted checkout via POST /v1/checkout-sessions and verification via GET /v1/checkout-sessions/{id}.

Requirements

• PrestaShop 1.7+
• Shop currency EUR, USD, or XOF

Step 1, Get your lomi. API keys

1. Sign in to dashboard.lomi.africa.
2. Open Developers → API keys and copy your Test secret key.

Step 2, Install the module

1. Open the lomi folder in lomiafrica/prestashop; the archive root must be lomi/ and include lomi.php.
2. Zip only that folder (not a parent directory).
3. Back office → Modules → Module Manager → Upload a module → install, then Enable if needed.

Detailed steps: PrestaShop module README

Step 3, Prepare currencies

1. International → Localization → Currencies: activate EUR, USD, or XOF.
2. Payment → Preferences (or Payment methods), allow lomi. for those currencies.

Step 4, Configure lomi.

Modules → lomi. → Configure

1. Turn Test mode on.
2. Paste Test secret key and Test webhook secret.
3. Save.

Step 5, Check Setup health

The Setup health panel should show:

• API secret key: Configured
• Store currency: EUR, USD, or XOF
• API connection: GET /me succeeded

Copy the webhook URL from the panel into dashboard → Webhooks. Enable PAYMENT_SUCCEEDED and REFUND_COMPLETED.

Step 6, Run a test payment

1. Add a product and go to checkout.
2. Select Pay with lomi. and complete sandbox payment on hosted checkout.
3. Confirm the PrestaShop order is validated.

Go live

Turn Test mode off, paste live keys and live webhook secret, then run one real payment.

Webhook URL

Point your lomi. dashboard webhook to:

https://YOUR-SHOP/index.php?fc=module&module=lomi&controller=webhook

Your shop may expose a friendly URL for the same controller, either works if it reaches the module front controller.

Payment flow

1. Customer chooses Pay with lomi. → POST to validation controller creates the checkout session and redirects to lomi. Checkout.
2. callback controller verifies the session (cart id + customer secure key), then validates the PrestaShop order when status is completed and amount/currency match.

Source: validation.php, callback.php, webhook.php

Shared docs

• Shared technical contract
• Verify payments

More docs

• E‑commerce hub