MTN Mobile Money (MoMo)
Quick Start
- Sign up at momodeveloper.mtn.com and obtain API credentials
- Create a terminal in the Admin Console with the parameters below
- Start processing — the adapter is pre-built and ready to use
Overview
MTN Mobile Money — Africa's largest mobile money platform. Supports Collection API (requesttopay) and Disbursement API (transfers). Coverage: GH, NG, UG, CM, RW.
| Provider ID | mtn_momo |
| Category | Mobile Money |
| Website | momodeveloper.mtn.com |
Supported currencies: UGX, GHS, XAF, XOF
Supported operations: charge (Collection), payout (Disbursement)
Authentication
- Method: OAuth2 Bearer Token + Ocp-Apim-Subscription-Key
- Base URL:
https://momodeveloper.mtn.com
Configuration
Required Parameters
| Parameter | Description |
|---|---|
subscription_key | Ocp-Apim-Subscription-Key |
api_user | API User |
api_key | API Key |
target_environment | Environment (sandbox / production) |
base_url | Base URL API |
Example Configuration
{
"provider": "mtn_momo",
"provider_params": {
"subscription_key": "your_subscription_key_here",
"api_user": "your_api_user_here",
"api_key": "your_api_key_here",
"target_environment": "production",
"base_url": "https://momodeveloper.mtn.com"
}
}
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
SUCCESSFUL | charged | Transfer completed |
PENDING | charging | Awaiting confirmation |
FAILED | rejected | Transfer failed |