Here you will find guides, resources and references to build with MoMo.
Common Error Codes
| HTTP Code | Response Code | Description | Action |
|---|---|---|---|
| 409 | RESOURCE_ALREADY_EXIST | Duplicated Reference ID. Every request must have a unique reference ID; using an ID of the previous request will result in this error response. | Check X-Reference ID used is unique and is in UUID V4 format |
| 401 | ACCESS DENIED DUE TO INVALID SUBSCRIPTION KEY | Authentication failed.Credentials invalid.Header Ocp-APIM-Subscription-Key value is incorrect. | Check the User Profile Section to verify the related product subscription key is used. Collection, Disbursement and Remittance have different subscription keys. If the primary key doesn’t work, try the secondary key. Contact MTN support if both provided keys aren't working. Sandbox subscription key are located in https://momodeveloper.mtn.com/developer Production subscription key are located in https://momoapi.mtn.com/developer |
| 404 | RESOURCE NOT FOUND | Reference ID not found. Requested resource does not exist. Predominantly occurs with Get Status API and implies that the requested reference ID does not exist. This results in the Request to Debit or Transfer transaction being unsuccessful. | Check if the original request to pay or the transfer (disbursement) operation was successful with response code 202. |