Errors

Lipila uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.). Codes in the 5xx range indicate an error with Lipila's servers (these are rare).

Error Codes

Code	Description
400	Bad Request - The request was unacceptable, often due to missing a required parameter.
401	Unauthorized - No valid API key provided.
402	Request Failed - The parameters were valid but the request failed.
403	Access denied - The request was valid but the user does not have permission to access
404	Not Found - The requested resource doesn't exist.
429	Too Many Requests - Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500	Server Error - Something went wrong on Lipila's end.

For example, if you make a request with an invalid API key, you'll receive a 401 Unauthorized response with the following body:

{
  "statusCode": 401,
  "message": "Unauthorized"
}

If you make a request with an invalid parameter, you'll receive a 400 Bad Request response with the following body:

{
  "statusCode": 400,
  "message": "Bad Request"
}

If you make a request to the disbursement api, you'll receive the error below, Please contact us to whitelist your IP:

{
  "statusCode": 403,
  "message": "Access denied"
}

Transaction Failure Reasons and Explanation

Account is locked : Payee account is locked due to multiple failed login attempts. Please contact MNO to unlock the account.

Balance insufficient : The Payee's account balance is insufficient to complete the transaction.

Could not process transaction due to network error, please try again : There was a network error while processing the transaction. Please try again.

COULD_NOT_PERFORM_TRANSACTION Transaction could not be performed due Missing fields.

Dear Customer, your account is locked, your default PIN is 1234. Change this PIN first and then proceed with your Airtel Money transaction. : The user's account is locked and the default PIN is provided.

LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWED : Account balance is low or payee limit has been reached or the payee is not allowed.

Service Charge not defined : Please contact us tech@hobbiton.co.zm

The PIN you have entered is incorrect. Pin should be numeric only and nonnegative : User entered the wrong pin

Transaction id is invalid: Each transaction ID should be Unique

Transaction status is ambiguous from mno side at the moment: Transaction status is ambiguous from MNO side at the moment.

Wrong PIN : User entered the wrong pin.