Error Codes

Request Error Codes

The table below contains the error codes returned by the application.

Error Code	Error Detail	Error Description	Possible Resolution
200/201	SUCCESS/CREATED	The transaction was successfully initiated
400	ERROR	The transaction encountered an error	Check Account Balance Check Payload Currency
401	UNAUTHORIZED	The transaction is unauthorized	Check your credentials (API key)
404	NOT FOUND	The request could not be processed due to invalid input or business rule violation.	Check that all required fields are present. Check the request URL
500	SERVER ERROR	The server encountered an error	IP is not whitelisted Server is down

Example Error Response (400 Bad Request)

If required parameters are missing or invalid, you'll receive a validation error:

[
  "amount should not be null or undefined",
  "amount should not be empty",
  "amount must be a number conforming to the specified constraints",
  "reason should not be null or undefined",
  "reason should not be empty",
  "reason must be a string",
  "accountNumber must be a string",
  "accountNumber must be at least 1 character long",
  "accountNumber should not be empty",
  "accountNumber is required",
  "currency should not be null or undefined",
  "currency must be one of the following values: GHS, NGN, UGX, XOF, XAF, KES, TZS, ZMW, GBP, EUR, USD, USDC, USDT",
  "currency should not be empty",
  "currency must be a string",
  "network should not be null or undefined",
  "network should not be empty",
  "network must be a string",
  "network must be at least 1 character long",
  "network should not be empty",
  "network is required",
  "accountName must be at least 1 character long",
  "accountName should not be empty",
  "accountName is required",
  "accountName must be a string",
  "unable to resolve accountname",
  "reference is required",
  "Only one recipient at a time please!"
]

{
  "message": "Unable to resolve account name for 0211212123",
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": [
    "currency must be one of the following values: GHS, NGN, UGX, XOF, XAF, KES, TZS, ZMW, GBP, EUR, USD, USDC, USDT"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": [
    "accountNumber should not be empty"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": [
    "currency must be one of the following values: GHS, NGN, UGX, XOF, XAF, KES, TZS, ZMW, GBP, EUR, USD, USDC, USDT",
    "currency should not be empty"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": [
    "network should not be empty"
  ],
  "error": "Bad Request",
  "statusCode": 400
}