Response Codes
Chipdeals Mobile Money Payments API uses conventional HTTP response codes to indicate the success or failure of requests.
We discuss some common errors and their causes below.es.
Bad request
Status Header Code: 400
The server cannot process the request due to an error in the request. For example, an error in the data passed to the request or a non-existent request URL.
Unauthorized Request
Status Header Code: 401
Invalid authentication credentials. The API key used in the request is invalid.
Request prohibited
Status Header Code: 403
Your request contains valid data and has been understood by the server. But the requested action is not possible. This may be because you do not have the necessary permissions for the request you are making.
It can also be an action that cannot be performed. For example, making a money transfer with a balance less than the amount you are trying to send.
Requested resource not found
Status Header Code: 404
The requested resource could not be found. For example a transaction with a non-existent reference.
Server error
Status Header Code: 500
A generic error message. This error occurs when an unexpected condition has been encountered on our server and no more specific message is appropriate.
Transaction Status Codes
When you initiate a payment, or try to check the status of a payment, we return an object to you containing the details of the payment. The statusMessageCode property present in the body of the response makes it possible to accurately determine the current status of a payment
| Code | State | Meaning |
|---|---|---|
| 200 | success | Transaction Completed Successfully |
| 201 | pending | Validation of current transaction information |
| 202 | processing | Transaction being processed |
| 203 | pending | Valid payment information |
| 204 | pending | Awaiting validation of payment by the user |
| 400 | error | Invalid transaction information |
| 401 | error | Incomplete transaction information |
| 402 | error | Invalid payment receipt number |
| 403 | error | Invalid beneficiary number |
| 404 | error | Payment not approved by payer |
| 406 | error | Number not linked to a mobile money account |
| 407 | error | Validation of payment already pending on this account |
| 408 | error | A transaction of the same amount on this account is already in progress. |
| 409 | error | The beneficiary has reached the maximum receivable amount authorized per month on this account. |
| 410 | error | The amount you entered in the request is less than the required minimum |
| 411 | error | The amount you entered in the request is greater than the maximum allowed |
| 413 | error | The maximum allowed failed payments has been reached. Execute the transaction again after 24 hours |
| 414 | error | This credit card does not have 3DS authentication activated. |
| 460 | error | This account does not have enough funds to make the payment. |
| 461 | error | An error occurred during payment |
| 462 | error | We do not yet support transactions with this Mobile Money operator. |
| 462 | error | We do not yet support transactions for this country. |
| 5XX | error | An error has occurred on the server. Our developers are aware. We fix it. |
| 505 | error | An error occurred with the network operator while executing the transaction. |
Error Codes
Here we list the possible error codes during your requests to the API.
An error code is present in a response when an error has occurred while processing the request.
{
"success": false,
"message": "Endpoint not available",
"errorCode": "400-000" // error code
}
| Code | Status Header code | Meaning |
|---|---|---|
| 400-000 | 400 | URL does not exist |
| 400-001 | 400 | Some data you sent is not correct |
| 400-100 | 400 | Parameter senderFirstName not found in request |
| 400-101 | 400 | senderFirstName parameter contains invalid data |
| 400-102 | 400 | Parameter senderLastName not found in request |
| 400-103 | 400 | senderLastName parameter contains invalid data |
| 400-104 | 400 | Parameter senderPhoneNumber not found in request |
| 400-105 | 400 | senderPhoneNumber parameter contains invalid data |
| 400-106 | 400 | amount parameter not found in request |
| 400-107 | 400 | amount parameter contains invalid data |
| 400-110 | 400 | Parameter recipientPhoneNumber not found in request |
| 400-111 | 400 | recipientPhoneNumber parameter contains invalid data |
| 400-116 | 400 | Requested currency not supported |
| 400-117 | 400 | currency parameter not found in request |
| 400-118 | 400 | currency parameter contains invalid data |
| 400-120 | 400 | The sender's country code phoneNumber is not activated with your API key |
| 400-121 | 400 | The country code of the recipient's phone number is not activated with your API key |
| 400-122 | 400 | Wrong payer network operator |
| 400-123 | 400 | Wrong recipient's network operator |
| 400-124 | 400 | The carrier of the sender's phone number is not yet supported |
| 400-125 | 400 | The operator of the recipient's phone number is not yet supported |
| 400-129 | 400 | Country not supported |
| 401-100 | 401 | Incorrect API key |
| 404-100 | 404 | No transaction with this reference found |
| 403-100 | 403 | Insufficient balance to make a payment |
| 500-000 | 500 | Server Error |
| 500-001 | 500 | An error occurred while converting currencies. |