Installation Guide

Get MOMO LENS up and running for your business. Choose the installation method that best fits your needs.

Mobile App Installation

The MOMO LENS mobile app is the primary way to use the platform. It's available for both iOS and Android devices.

iOS Installation

Open the App Store on your iPhone or iPad
Search for "MOMO LENS" or "Smart Till"
Tap "Get" to download and install
Open the app and sign in with your account

Android Installation

Open Google Play Store on your Android device
Search for "MOMO LENS" or "Smart Till"
Tap "Install" to download and install
Open the app and sign in with your account

Offline-First

The mobile app works offline. Your data syncs automatically when you have an internet connection.

API Integration

If you're building a custom integration or connecting MOMO LENS to your existing systems, you'll need to set up API access.

1. Get API Credentials

Contact our support team to get your API credentials. You'll receive:

Your merchant ID
API access credentials
Base API URL

2. Base URL

All API requests should be made to:

https://momolens-production.up.railway.app/api/v1

3. Authentication

Use JWT Bearer token authentication. See our Quick Start Guide for authentication details.

4. SDKs and Libraries

While we don't provide official SDKs yet, our REST API is straightforward to use with any HTTP client. Here are some examples:

JavaScript/TypeScript

const response = await fetch('https://momolens-production.up.railway.app/api/v1/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'your-email@example.com',
    password: 'your-password'
  })
});

const data = await response.json();
const token = data.access_token;

Python

import requests

response = requests.post(
    'https://momolens-production.up.railway.app/api/v1/auth/login',
    json={
        'email': 'your-email@example.com',
        'password': 'your-password'
    }
)

data = response.json()
token = data['access_token']

Configuration

Mobile App Settings

Currency: Set your primary currency in Settings
Mobile Money Providers: Configure your mobile money accounts
Offline Mode: Enabled by default - works without internet
Sync Frequency: Automatic sync when online

API Configuration

Rate Limits: 100 requests per 15 minutes per user
Timeout: 30 seconds for most endpoints
Pagination: Use query parameters for paginated endpoints

Documentation