Ask the MoMo Community

Hello,I cannot subscribe to the Collections product in the sandbox. The subscriptionrequest fails server-side with HTTP 400.Steps to reproduce:1. Log in to momodeveloper.mtn.com2. Go to Products > Collections3. Enter a subscription name, accept the terms, click SubscribeRequest:POST /developer/users/<my-user-id>/subscriptions/<id>?api-version=2022-04-01-previewResponse: HTTP 400 Bad Request{"error":{"code":"ValidationError","message":"You've reached the maximum numberof Subscriptions (25000) in Product. Please delete one or more Subscription(s)from Product to continue, or consider upgrading your plan to increase thelimit.","details":null}}My account has no subscriptions at all — the page shows "You have nosubscriptions yet". The 25000 limit is the Azure API Management cap on theProduct itself, not on my account, so there is nothing I can delete on my side.Could someone on the MoMo team clean up stale sandbox subscriptions on theCollections product, or raise the APIM tier

Account: weruku@gmail.com (registered 09/11/2026). I cancelled Collection Widget (mpf-widget). I cannot subscribe to Collections — the button does nothing and the new subscription never appears on my profile. I need sandbox Collections (not Widget) for Uganda.

Hello,I am trying to subscribe to the Collections product on the MTN MoMo Developer Portal in order to integrate MTN MoMo Côte d’Ivoire with our OneFlow platform.However, the subscription creation consistently fails with an HTTP 400 error and the following message:You've reached the maximum number of Subscriptions (25000) in Product. Please delete one or more Subscription(s) from Product to continue, or consider upgrading your plan to increase the limit.Could you please increase the subscription capacity for the Collections product or enable my subscription manually?Requested subscription name: OneFlowPay-Collections-Sandbox-CII can also provide screenshots of the failed POST request and the full error response if needed.Best regards,

How to get my api key

I have successfully registered on the MTN MoMo Development Portal and subscribed to Collection Widget. However, when I try to subscribe to the Collections API product, clicking subscribe does not create a subscription. My profile still shows only Collection Widget as Active. I need the Collection API for RequestToPay integration. Please assist with enabling the Collections API subscription on my developer account. 

I'm building a marketplace-style platform where a payment is collected upfront but shouldn't be paid out immediately — it needs to be held and only released to the recipient once the payer approves a completed stage of work, which could be a few days after collection.Is there any native support in the Collections/Disbursements APIs for a conditional or delayed release like this, or is holding funds purely something I'd need to handle in my own backend — i.e., collect immediately via the Collections API, hold the amount in my own ledger, and only call Disbursements once the stage is approved? Trying to understand where the boundary is between what the API handles and what has to live entirely on my side. Any guidance appreciated.

Hello MTN MoMo Team,I am developing Amasampo Palletmarket, an online marketplace operating in Zambia where sellers can list products and buyers can find and purchase items.I would like to integrate MTN MoMo so that our website can receive real payments, including seller subscription/listing fees and potentially customer payments.I have already created an MTN MoMo Developer account and I am interested in the Collections API or Collection Widget for Zambia.I would like guidance on the requirements for going live in Zambia. In particular:Can an individual or sole proprietor apply for production access, or must the business first be formally registered?What KYC documents are required in Zambia?Do I need an MTN MoMo merchant/business wallet for Collections?I currently have an MTN MoMo agent line. Can this line be used for API Collections, or will I need a separate merchant/business MoMo account?Which product should I apply for if I want customers to make payments directly from their MTN MoM

Hello,My name is Nana, and I’m working on a POS platform for businesses in Ghana.We are currently integrating Mobile Money payments into Tabworthy through a payment provider (Paystack), and we have encountered a customer authentication flow that we'd like to understand directly from MTN.The current flow for an MTN customer making their first MoMo payment through our application is: The customer provides their MTN phone number. We initiate the Mobile Money payment. MTN sends a 6-digit code to the customer's phone. The customer has to provide that 6-digit code to the merchant/cashier. The code is entered into the payment flow. The customer then receives the normal MTN MoMo prompt and enters their MoMo PIN. The payment is completed. Interestingly, after the customer completes this process once, subsequent payments do not appear to require the 6-digit code again.Our payment provider has confirmed that this 6-digit code is generated and controlled by MTN and that they cannot byp

Hello,I’m writing this topic because we have successfully completed the integration and sandbox testing of the MTN MoMo Collections API into Equinox, our SaaS invoicing and payment platform : equinox.passerel.caSeveral customers are waiting for us to enable MTN Mobile Money payments in production.Cabinet Passerel, the company operating Equinox, is incorporated in Canada. During the Go-Live process for Benin, we noticed that the onboarding documents request local information such as an IFU, physical address and other Benin-specific company documentation.Can a Canadian company obtain production access to the MTN MoMo Collections API for Benin, or is a locally registered entity/establishment required ?Our technical integration is already complete and working successfully in the sandbox.Best regards,

Hello,I am integrating the MTN MoMo Remittance Sandbox API from a cloud-hosted server environment.The integration previously worked successfully. We were able to:generate an OAuth access token; validate a Sandbox account holder; submit a Remittance transfer (202 Accepted); retrieve the transfer status as SUCCESSFUL.However, the OAuth endpoint is now being rejected:POST https://sandbox.momodeveloper.mtn.com/remittance/token/Instead of the documented OAuth JSON response, MTN returns:HTTP status: 200 Content-Type: text/html Content-Length: 247 message: Request RejectedA Support ID is also returned for the rejected request.The issue appears consistent with a Sandbox WAF/network restriction affecting server-to-server requests from a cloud environment.Could you please confirm:whether the MTN Sandbox WAF may be blocking our server requests; whether an outbound IP or IP range needs to be allowlisted; whether there are specific network/IP requirements for server-to-server access to the Remittan

Hi, I'm integrating the MoMo Collections API (sandbox) into a server-side application. Requests to /collection/v1_0/requesttopay are being rejected with a WAF block page ("Request Rejected... The requested URL was rejected. Please consult with your administrator") when sent from my cloud-hosted server (Render.com), even though the exact same request succeeds when sent from my local machine using identical code and credentials. Could someone confirm whether cloud/datacenter IP ranges are blocked in sandbox, and if so, help whitelist these outbound IP ranges for my app? 74.220.51.0/24 74.220.59.0/24 Account details: API User ID: b3342b64-ffd2-4746-a771-b884953cc72e Thank you!

Hello, I am a developer in Uganda building a Flutter web/mobile application called Walking With Christ. I already have an MTN MoMo merchant code and would like to integrate the MoMo API Get Paid/Collections service.When I go to the MoMo API developer portal and click “Sign up with MoMo API,” I am redirected to momoapi.mtn.com/signup, which returns Error 404.Please advise how I can create a new MoMo API developer account and obtain sandbox access for Uganda.

Hello, I am a developer in Uganda building a Flutter web/mobile application called Walking With Christ. I already have an MTN MoMo merchant code and would like to integrate the MoMo API Get Paid/Collections service.When I go to the MoMo API developer portal and click “Sign up with MoMo API,” I am redirected to momoapi.mtn.com/signup, which returns Error 404.Please advise how I can create a new MoMo API developer account and obtain sandbox access for Uganda.

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

Hello MTN MoMo Support/Community,I am integrating the MTN MoMo Collections API for my application, Glowza.I have an active Sandbox subscription:Product: CollectionsSubscription: FakorBorla SandboxEnvironment: SandboxI am trying to provision an API User using the Sandbox User Provisioning API.Endpoint:POST https://sandbox.momodeveloper.mtn.com/v1_0/apiuserRequest headers:X-Reference-Id: [fresh UUID v4]Content-Type: application/jsonOcp-Apim-Subscription-Key: [Collections Primary Subscription Key]Request body:{  "providerCallbackHost": "webhook.site"}The request consistently returns:HTTP/1.1 400 Bad RequestContent-Length: 0There is no response body explaining the error.I have also tried the GET API User endpoint with the same UUID:GET /v1_0/apiuser/{X-Reference-Id}This also returns:HTTP/1.1 400 Bad RequestI have verified that:- The subscription is active.- The subscription product is Collections.- I am using the Collections Primary Subscription Key.- The subscription key is 32 characters.

The Sandbox Collection token/payment flow and Sandbox User Provisioning endpoint are returning HTTP 500 Internal Server Error.I tested both the Primary and Secondary Collection subscription keys, but received the same result.Endpoint:POST https://sandbox.momodeveloper.mtn.com/v1_0/apiuserActivity IDs:e8bd5c96-1955-4c73-9b47-285372a833f0c7d94c70-d94b-419f-81f3-1b3f9606a18e903d8124-fc15-4129-9c88-a47d8c410224Please confirm whether the sandbox services are currently operational and advise when they will be restored.

Hitting 500, while trying to create api user key ??Please help us know,if its sandbox provisioning down or other thing else, or if the server is intentionally down mean like under maintenance !

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?