Welcome to MoMo APIs

Here you will find guides, resources and references to build with MoMo.

Steps on creating your first API Request

  1. Fork Collection
  2. Create Subscription Keys
  3. Create API User and API Key
  4. Get Access Token
  5. Make your first MoMo API Call

Step 1: Fork the collection using Run In Postman

Step 2: Create Subscription Keys

1. Sign up https://momodeveloper.mtn.com

2. Navigate to the products page Product-descriptions.

3. Select drop down on product that suits the business case and subscribe.

4. After completion, you can locate the Subscription Keys in your profile. Access additional information through the link below on creating subscription keys
How to create subscription keys on MoMoDeveloper | MoMo Dev Community (mtn.com)

5. Navigate to the Variables and update as mapped below

Subscription Name Key Type Variable
Disbursements Primary Disbursement_Subscription-Key
Collections Primary Collection_Subscription-Key

NOTE: Use the primary key

Step 3: Generate API user and API Key

1. Fork the SandBox Provisioning Collection using run in Postman

2. Run the SandBox Provisioning Collection, copy the api user and api key displayed via the console and test results.

3. Navigate to the Variables of the MoMo Open APIs Collection and modify api_user and api_key respectively

Step 4: Generate API user and API Key

An access token is automatically generated using a default api_user and api_key. MoMo recommends using your own api_user and api_key from Step 3 by entering the values under the Variables tab. A pre-request script will generate and manage expiry of the access_token automatically.

Step 5: Make Your first MoMo API Call

1. In your workspace, navigate to your fork of the MoMo Open APIs collection.

2. Select Get Paid > Request Payment

3. Select the Send button to request a payment. On a successful call, the API returns a 202 Accepted response code

4. Customer will receive a PIN to approve the debit from their MoMo Wallet.

5. Check configured Callback URl for status of the Request.

6. Request Status can be generated under select Get Paid > Payment Status

7. Select the Send button to request a payment. On a successful call, the API returns a 200 OK Accepted response code, with Status of the request in the response body