HTTP Code	Error 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.
400	REQUEST REJECTED/ BAD REQUEST	Bad request. Request does not follow the specification.	This relates to any of the below scenarios: - Incorrect/wrong values in the headers, and/or the X-ref ID does not meet UUID Version 4. - Inputting a Body in an API that is not supported e.g. /Token API - Having unsupported special characters in the Body request for example an apostrophe ('). - Invalid currency – needs to match the target environment currency. - More than 160 characters in the note and message; explore utilizing the notification API for increased number of characters. - The URL posted to needs to reviewed e.g. incorrect number of forward slashes (///).
403	FORBIDDEN IP	Authorization failed. IP not authorized to utilize Disbursement API.	Share your originating Public IP from which the APIs are called with your MTN Account Manager.
500	NOT_ALLOWED	Authorization failed. User does not have permission.The account authenticated with the Request via Token is restricted.	Contact your MTN Account Manager.
500	NOT_ALLOWED_TARGET_ENVIRONMENT	Value passed in header X-Target-Environment is incorrect	Use the correct X-targetenvironment corresponding to below country: - MTN Uganda= mtnuganda - MTN Ghana= mtnghana - MTN Ivory Coast= mtnivorycoast - MTN Zambia= mtnzambia - MTN Cameroon= mtncameroon - MTN Benin= mtnbenin - MTN Congo= mtncongo - MTN Swaziland= mtnswaziland - MTN GuineaConakry= mtnguineaconakry - MTN SouthAfrica= mtnsouthafrica - MTN Liberia= mtnliberia For Test Environment = sandbox
500	INVALID_CALLBACK_URL_HOST	Callback URL with different host name to configured for API User. Check the Host of the Call Back URL in the request header; this needs to match what was configured on the partner portal when creating the API user and Key.	Host needs to be configured using Hostname and not IP address.
500	INVALID_CURRENCY	Currency not supported on the requested account	Use Currency Code specific to the Country.
503	SERVICE_UNAVAILABLE	Service temporary unavailable, try again later	Enquire with MTN Support.