Quick Start Guide

Get up and running with the MOMO LENS API in just a few minutes. This guide will walk you through authentication, making your first API call, and understanding the basics.

Prerequisites

• A MOMO LENS account (register at our website)
• Your API credentials (email and password)
• HTTP client (cURL, Postman, or your preferred tool)

Step 1: Authenticate

All API requests require authentication using JWT tokens. Start by logging in to get your access token.

curl -X POST https://momolens-production.up.railway.app/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

You'll receive a response with your access token:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "...",
  "expires_in": 3600,
  "user": {
    "id": "user-id",
    "email": "your-email@example.com",
    "merchantId": "merchant-id"
  }
}

Step 2: Make Your First API Call

Now that you have your access token, let's fetch your merchant information:

curl -X GET https://momolens-production.up.railway.app/api/v1/merchants/your-merchant-id \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Step 3: Explore the API

Now you're ready to explore all available endpoints. Check out our interactive API documentation:

Common Endpoints

Next Steps

• Explore the full API reference
• Learn about mobile money integration
• Get support from our team