Ask the MoMo Community

Hello MTN MoMo team,I'm reporting a sandbox issue that started around 7 July 2026 and that I've been unable to resolve through the usual troubleshooting. I'd be grateful for your guidance on the likely cause and the recommended next step.SummaryMy Collections product subscription shows Active in the portal, and its subscription keys are accepted by the API gateway — but every request that is passed through to the backend hangs and never returns, timing out after roughly 30 seconds. This affects token generation and API-user management alike, so I cannot obtain an access token or provision a new API user.Behaviour observed (reproduced independently from two different networks using raw HTTP, so it is not specific to my application or hosting):Request Result POST /collection/token/ — valid Collections key + existing API user Times out (~37s), no response GET /v1_0/apiuser/{referenceId} — existing API user Times out (~21s), no response POST /v1_0/apiuser — create a new API user

im a developer i need help

Hello,I’m ready to proceed live with the application; however, I am experiencing an issue uploading the required documents. The submission portal only allows uploads up to 10MB, while the total size of the required documents is approximately 22MB.Could you please advise on how I should submit the application and supporting documents for approval? For example, should I: submit the documents in multiple batches, compress the files, or send them via email or another upload method? Thank you, and I look forward to your guidance.Kind regards,Queen 

Alright guys,If anyone is in the momo developers community WhatsApp group Kindly just comment below/ comment your number/ admin add it on each section respectively to each country I think this will help many , if we can join in real group conversation/support, Guys like and keep this pinned 🫡if you found this good

I am trying to generate an api user and key for the sandbox environment.I am sure i am using the correct subscription key, and uuid.I tried the postman collection online. This returns the error: access_token or its expiry date are missing.Authentication is set to none, and i could not get this working.I then tried to create this request in a local postman install.The request looks the same as the online version, but returns error 404.The response body isContent-Length: 0Strict-Transport-Security: max-age=31536000; includeSubDomainsX-XSS-Protection: 1; mode=blockRequest-Context: appId=cid-v1:e996501c-e721-4ac1-97ff-dc6887b85e8cDate: Thu, 14 May 2026 10:02:01 GMT I have these headers: Ocp-Apim-Subscription-Key, X-Reference-Id, Content-Type. The request body is : {"providerCallbackHost":"www.google.com"}Any suggestion to resolve this will be highly appreciated. 

Hi team,Very Urgent. Kindly assist with your KYC API Service Production Keys. Please Provide reference document for the KYC APi service. warm regards. 

What is the difference between a RequestToPay and a RequestToWithdraw

Hi @all,I configured a user and api key. The call works (requesttopay), but the callback is not executed.I added the host dev.domain.com.xyHeader param for callback is “http://dev.domain.com.xy/webhook/mtnmomo”.No callback.Creating another user with callback domain “domain.com” it works…Any issues with “uncommon” domainnames? 

Dear MTN Mobile Money Team, I hope you are doing well. My name is Maurice, and I am the founder of Bank of West Africa (BWA), a digital-first financial platform currently in the process of integrating with the MTN MoMo Open API for collections, disbursement, and remittance services. We are excited about the opportunity to partner with MTN Mobile Money and bring enhanced financial access across West Africa. However, while reviewing the onboarding documentation and requirements, we encountered a few areas where the current forms and questionnaires appear to be structured primarily for traditional merchants, agents, or remittance operators. Bank of West Africa operates as a fintech platform offering: - Digital banking services- Mobile wallet infrastructure- QR code payments- Virtual cards- Remittance and cross-border transactions- Bill payments and mobile top-ups- Installment-based financial services As such, some sections of the Merchant Application Form, KYC requirements, and AML questi

I’m getting invalid subscription key invalid while testing it in sandbox mode while testing it with live url it give resource not found.Below is for sandbox Mode.URL :: https://sandbox.momodeveloper.mtn.com/v1_0/apiuser headers :: {Authorization: Basic ZmY5NTZkMGYtODYwOC00NmZhLWIzMzEtZjRkNDhmNzAwZTNiOm51bGw=, X-Reference-Id: ff956d0f-8608-46fa-b331-f4d48f700e3b, Ocp-Apim-Subscription-Key: 84dbf7a8a0e44923988a0dd621169ec6, Content-Type: application/json} MtnMomo :: body :: {providerCallbackHost: https://dulu.cm/success} [log]MtnMomo :: apiuserAPI :: 401 :: { "statusCode": 401, "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription." }Below is for live testing URL :: https://proxy.momoapi.mtn.com/v1_0/apiuser headers :: {X-Reference-Id: 6e1fcdda-0cb1-4a85-8af6-8e3e6ff31942, Ocp-Apim-Subscription-Key: 0144c9f7b7774f4b8108cc4b243561b6, Content-Type: application/json}body :: {providerCallbackHost: https://dulu.cm/success}apiuse

I am building a platform that helps multiple businesses accept mobile money payments and automatically reconcile successful payments inside the system.I would like guidance on the best and officially supported setup for this model.My main concern is around how collections should work when one platform serves many merchant clients. If the integration is created under the platform account, does that mean funds are received into the platform’s collections account first, or can each client business receive its funds directly?We would prefer a setup where the platform does not have to hold or manage client funds if possible.I would also like to understand:whether each merchant needs its own setup or credentials whether there is any supported third-party, platform, or aggregator model whether it is possible to collect funds and immediately forward them to the merchant automatically whether extra charges apply in that kind of flow what the recommended approach is for this type of use caseAny

Hi Team,I am currently developing a recurring payment solution using the MoMo API (Ghana environment) and would like to clarify the expected behavior for pre-approval mandates to ensure a smooth user experience.1. Renewing Active Mandates:If an MSISDN already has an active pre-approval mandate, what happens if a second POST /preapproval request is sent to that same number before the current one expires?Does the new request overwrite the existing one and reset the validityTime? Does it return a PREAPPROVAL_EXIST_PENDING error even if the previous mandate is already in a SUCCESSFUL state? Is there a recommended way to "extend" a mandate without requiring the customer to perform a fresh approval?2. Maximum validityTime Constraints:Regarding the validityTime parameter in the POST /preapproval payload:What is the maximum allowable value (in seconds) for this field in the Ghana Production environment? Are there platform or regulatory caps (e.g., 365 days) that would cause a validation error

The request body below returns invalid currency. What currency codes work for Uganda? Tried altering the currencies but same error.{ "amount": "40000", "currency": "UGX", "externalId": "c1f4687688585858a173f12", "payer": { "partyIdType": "MSISDN", "partyId": "25678119xxxx" }, "payerMessage": "Payment for services", "payeeNote": "Payment for services"}

Hello MTN Developer Support,I have just started using the MTN Developer Portal and I am currently a student. I do not yet have a taxpayer number (NIU) or the business documents that are normally required for registration.I would like to know if there is a way for students or individuals without a taxpayer number to gain access to MTN APIs for learning, testing, or development purposes.Thank you for your guidance. 

Dear MTN MoMo Developers Team,I amSoftware Engineering student currently developing a Django-based web application that requires real-time MTN MoMo payment integration.I am writing to respectfully seek your technical guidance and support regarding the proper implementation of MTN MoMo APIs within my project. Specifically, I would like assistance with configuring secure API authentication, handling payment request callbacks (webhooks), and ensuring real-time transaction verification within a Django backend environment.My goal is to implement a robust and production-ready integration that complies fully with MTN MoMo developer standards and security requirements. I have reviewed the available developer documentation, but I would greatly appreciate clarification and best-practice recommendations, particularly concerning sandbox testing, callback URL configuration, and transaction status confirmation.Kindly let me know if there are recommended resources, SDKs, sample Django implementations

Our development team requires specialized technical guidance for MTN MoMo platform integration and mobile money solution development. We're searching for an experienced consultant available for 1-2 weeks to assist with:Architecting comprehensive mobile money workflows and payment processing systems Implementing secure API authentication, user management, and transaction handling Building scalable financial service solutions with robust testing and validation procedures Developing integration strategies for collection, disbursement, and remittance capabilities Providing technical coaching on implementation best practices and production deploymentPrior experience with MTN MoMo API development, mobile payment platforms.

We are no longer able to generate disbursement token since last few days. It was working before.The URL -  https://sandbox.momodeveloper.mtn.com/disbursement/token/Response Received:<html><head><title>Request Rejected</title></head><body>The requested URL was rejected. Please consult with your administrator.<br><br>Your support ID is: 14332579245721589193<br><br><a href='javascript:history.back();'>[Go Back]</a></body></html> 

Hi, getting the 500 internal server error without any details when trying to create API user as described here:https://momodeveloper.mtn.com/api-documentation/api-descriptionThe same result is with “Try it” feature on the site (https://momodeveloper.mtn.com/API-collections#api=sandbox-provisioning-api&operation=post-v1_0-apiuser&definition=ApiUser) and when calling it from the VPS. HTTP/1.1 500 Internal Server Errorcontent-length: 111content-type: application/jsonvary: Origin{ "statusCode": 500, "message": "Internal server error", "activityId": "93a3063e-****"}The system returns Activity ID where can I find details related to it?

Issue 1: Cannot Create New Pre-Approval After ExpiryDescription:After a pre-approval mandate expires, attempts to create a new pre-approval for the same MSISDN consistently fail.Steps to Reproduce:Create a pre-approval mandate for an MSISDN.Allow the pre-approval to expire.Attempt to create a new pre-approval mandate for the same MSISDN.Actual Result:The request fails with the following response:{  "message": "Preapproval already exist and is in pending state",  "code": "PREAPPROVAL_EXIST_PENDING"}Despite this, the MSISDN holder still receives an STK Push to approve the transaction,when a normal request to pay is initiated on the MSISDN which suggests the previous pre-approval is no longer active.Expected Result:Once a pre-approval has expired, the system should allow the creation of a new pre-approval mandate for the same MSISDN.Issue 2: Get Approved Pre-Approvals Endpoint Not SupportedDescription:The Get Approved Pre-Approvals API is not supported in the Ghana target environment.Step

i am using both stripe and momo in my web app.I have dollar currency of my platform.i am wondering if i convert the currency to local one based on users location on my end.it will be less reliable.DOES Momo supports the dollar currecny and convert it on its own.or what to do. 

Hello, How can I get API keys for get Paid (Collections | Enable remote collection of bills, fees or taxes.) of production?

I want to create an MTN MOMO merchant account. Who can help 

Hi everyone,I’m having some trouble with the MTN MoMo API, specifically with the requestToPay endpoint.When I send a requestToPay, I get an HTTP 200 response, but the body looks like this: HTTP/1.1 200 OK cache-control: no-cache content-length: 247 content-type: text/html; charset=utf-8 pragma: no-cache vary: Origin x-content-type-options: nosniff x-frame-options: SAMEORIGIN x-xss-protection: 1; mode=block <html> <head><title>Request Rejected</title></head> <body> The requested URL was rejected. Please consult with your administrator.<br><br> Your support ID is: 11597720049318046811<br><br> <a href='javascript:history.back();'>[Go Back]</a> </body> </html> The problem is that no callback is ever sent, even though I receive this 200 response.Has anyone experienced this before or knows what might be wrong? Any help would be appreciated. 🙏 

Please assist, I am getting this error from the andbox  

Hello all, I would like to know how can I send a credit or package for communication to a customer, via MoMo API routes. What can be the process and what are different identifications required on that. The SIM card which makes the operation is a merchant one. Can you help me please