Banking and mobile money OTPs by SMS in Uganda
Commercial banks in Uganda are supervised by the Bank of Uganda, which also oversees payment systems, including mobile money, under the National Payment Systems Act 2020. When a customer logs in or approves a payment, the bank's or payment provider's system generates the code and calls the 4notify REST API, which delivers it by SMS to MTN and Airtel subscribers. Push and email are available as additional channels through the same API.
A one-time code is part of a bank's fraud controls: the customer must receive it from a name they recognise, and the bank must know what was sent, when and with what status. The Bank of Uganda's framework for banks, payment systems and consumer protection shapes how these messages and the data behind them are handled.
Delivery to MTN Uganda and Airtel Uganda subscribers, with an alphanumeric sender ID registered under each network's rules.
Laws and rules cited
- Financial Institutions Act 2004Licensing and supervision of commercial banks and credit institutions by the Bank of Uganda.
- National Payment Systems Act 2020Licensing and oversight of payment systems and payment service providers, including mobile money.
- Bank of Uganda Financial Consumer Protection Guidelines 2011Fair treatment, transparency and complaint handling in a financial service provider's dealings with customers.
How it works
- 1The code is generated by your systemYour authentication system creates and verifies the code. 4notify receives only the ready-to-send text and the recipient's number.
- 2The API callYour system obtains a JWT with client_credentials and sends POST /api/v1/sms with the number, sender ID and text.
- 3Delivery on MTN and AirtelThe message leaves through the 4notify relay or your own SMS provider; if one route fails, 4notify switches automatically to the next configured SMS route.
- 4Delivery statusEach message's status is visible in the panel and the API; the bank keeps the records its own control policies require in its own systems.
Event payload
{
"event": "bank.otp.payment",
"to": "+256772123456",
"sender": "BANK",
"text": "Your code is 481922. It expires in 5 minutes. Never share it.",
"reference": "TXN-2026-11-19-5521",
"amount": 250000,
"currency": "UGX"
}Sample message
Compliance checklist
- ✓The code is generated and verified only in your own system
- ✓Alphanumeric sender ID approved on MTN and Airtel
- ✓API calls authenticated with a JWT (client_credentials)
- ✓Delivery status reviewed in the panel or through the API