Reliability
Webhooks, payment verification, testing, and the operational practices that keep an integration safe in production.
Use this folder for the operational layer of a lomi. integration: receive events, confirm payments, and test failure paths.
- Handling webhooks: receive, verify, and subscribe to events.
- n8n webhook recipe: verify
X-Lomi-Signaturein n8n and send WhatsApp or email. - Webhook reliability: retries, duplicates, timeouts, and delivery logs.
- Verify payments: confirm status with the API and webhooks, never from the browser redirect alone.
- Payment lifecycle: how money-in and money-out statuses connect.
- Testing: how to structure sandbox and production tests.
- Simulate errors: the scenario matrix for declines, pending Mobile Money, and webhook failures.
Test credentials and card numbers live on Sandbox payments. Error codes live on Errors.
Handling webhooks
Webhooks provide real-time updates about events in your lomi. account. This guide explains how to securely receive and process these notifications.
n8n webhook recipe
Receive a signed lomi. PAYMENT_SUCCEEDED event in n8n and send a WhatsApp or email confirmation.
Webhook reliability
Retries, idempotency, delivery logs, and safe handling of duplicate events.
How do I verify a payment?
Confirm payment status server-side with the API and webhooks, never trust the browser redirect alone.
Payment and payout lifecycle
How money-in and money-out statuses connect, when pending payments expire, and how completion credits your balance.
Error handling
When integrating with lomi., handle API errors so customers get a clear payment outcome and your logs stay useful.
Idempotency keys
Idempotency ensures that an API request, if retried due to a network error or timeout, won't accidentally be performed multiple times. This is crucial for operations like creating payments or refunds to prevent duplicate actions.
Security best practices
Report a vulnerability, then lock down API keys, TLS, and webhook verification for your lomi. integration.
Testing guide
This guide covers best practices for testing your lomi. integration, ensuring your payment flows work correctly in both sandbox and production environments.
How do I simulate errors?
Test declines, authentication challenges, async mobile money, and webhook failures before go-live.
CI/CD
This guide covers best practices for integrating lomi. with your CI/CD pipeline, ensuring reliable deployments and automated testing.