Documentation

Everything you need to integrate, use, and get the most out of MOMO LENS.

Multi-Currency Guide

MOMO LENS supports multiple African currencies, allowing you to manage transactions in your local currency and handle cross-border payments seamlessly.

Supported Currencies

MOMO LENS natively supports the following currencies:

Zambian Kwacha

ZMW

Symbol: K

Kenyan Shilling

KES

Symbol: KSh

Ugandan Shilling

UGX

Symbol: USh

Tanzanian Shilling

TZS

Symbol: TSh

Ghanaian Cedi

GHS

Symbol: GH₵

Nigerian Naira

NGN

Symbol: ₦

Setting Your Primary Currency

  1. Open the MOMO LENS app
  2. Go to Settings → Currency
  3. Select your primary currency
  4. Save your changes

Primary Currency

Your primary currency is used for default displays and reports. You can still process transactions in other currencies.

Processing Multi-Currency Transactions

In the Mobile App

  1. When creating a sale, select the currency
  2. Enter the amount in the selected currency
  3. The app automatically handles currency conversion for reporting
  4. All transactions are stored with their original currency

Via API

When creating transactions via API, specify the currency code:

POST /api/v1/merchants/{merchantId}/sales-records
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "amount": 100.00,
  "currency": "ZMW",
  "items": [...]
}

Currency Conversion

MOMO LENS uses real-time exchange rates for currency conversion in reports and analytics. Rates are updated automatically from reliable sources.

Exchange Rate Sources

  • • Central bank rates where available
  • • Market rates for real-time conversion
  • • Historical rates preserved for past transactions

Reporting with Multiple Currencies

Financial reports can be generated in:

  • Original Currency: View transactions in their original currency
  • Primary Currency: Convert all transactions to your primary currency
  • Multi-Currency: See breakdown by currency

API Endpoints

Get Supported Currencies

GET /api/v1/currencies

Get Exchange Rates

GET /api/v1/currencies/rates

Best Practices

  • Consistent Currency: Use your primary currency for most transactions
  • Record Original: Always record transactions in their original currency
  • Regular Reconciliation: Reconcile multi-currency transactions regularly
  • Exchange Rate Awareness: Be aware of exchange rate fluctuations for reporting

Next Steps