--- agentTools: projectIndex: https://chimoney.readme.io/llms.txt --- # ErrorCodes Learn more about error codes and how to resolve them. ## Overview This document provides a comprehensive guide to the error codes used in our API. Error codes are short strings that describe specific issues encountered during API requests. They help in diagnosing problems and guiding appropriate resolution steps. ## Reviewing Errors Our system logs every successful and failed API request. To review errors and monitor your integration, use the Developers section of the Dashboard. Each error includes a code with a brief explanation and can be linked to this list for further details. ## Error Codes Below is a list of possible error codes, along with descriptions and recommendations for resolution. Each error code is associated with specific conditions that can occur during interactions with our API. ## Error Code Descriptions * **ALREADY\_MEMBER**\ **Description**: The sub-account is already a member of the community.\ **Resolution**: Check the community member's status before attempting to add them again. * **AIRTIME\_NOT\_SUPPORTED**\ **Description**: Airtime services are not supported.\ **Resolution**: Verify that airtime services are enabled for your account and supported in the target region. * **APPROVAL\_REQUIRED**\ **Description**: The action requires approval before it can be performed.\ **Resolution**: Follow the approval process outlined in the API documentation. * **BANK\_ACCOUNT\_NOT\_FOUND**\ **Description**: The specified bank account cannot be found.\ **Resolution**: Ensure that the bank account details are correct and that the account exists in the system. * **BANK\_LOOKUP\_FAILED**\ **Description**: A bank lookup operation failed.\ **Resolution**: Verify the bank account details or country code and try the lookup operation again. * **BENEFICIARY\_ALREADY\_EXISTS**\ **Description**: A beneficiary already exists in the system.\ **Resolution**: Check if the beneficiary is already listed before creating a new entry. * **BENEFICIARY\_CREATION\_FAILED**\ **Description**: Creating a beneficiary failed.\ **Resolution**: Review the request parameters and ensure they comply with system requirements. * **BENEFICIARY\_UPDATE\_FAILED**\ **Description**: Updating a beneficiary failed.\ **Resolution**: Verify the update parameters and try the operation again. * **CACHE\_MISS**\ **Description**: Cache retrieval resulted in a miss.\ **Resolution**: Check cache configuration and ensure that the data is being correctly stored and retrieved. * **CHIMONEY\_NOT\_FOUND**\ **Description**: The specified `chimoney` object cannot be found.\ **Resolution**: Ensure that the `chimoney` object data ( `id`,`chiref`) is correct and the data exists in the system. * **CONTACT\_SUPPORT**\ **Description**: The user needs to contact support for further assistance.\ **Resolution**: Reach out to our support team for help with this issue. * **CURRENCY\_NOT\_FOUND**\ **Description**: The specified currency cannot be found.\ **Resolution**: Verify that the currency code is correct and supported by the system. * **DELETION\_NOT\_ALLOWED**\ **Description**: Deletion of the resource is not allowed.\ **Resolution**: Confirm if the resource can be deleted or if it requires special permissions. * **DUPLICATE\_ENTRY**\ **Description**: A particular data entry already exists.\ **Resolution**: Check for existing entries and avoid creating duplicates. * **EXCHANGE\_RATE\_FETCH\_FAILED**\ **Description**: Fetching the exchange rate failed.\ **Resolution**: Ensure that the exchange rate service is operational and retry the fetch request. * **GENERIC\_ERROR**\ **Description**: A generic, unspecified error occurred.\ **Resolution**: Review the error message and try to identify the cause based on context. * **INSUFFICIENT\_FUNDS**\ **Description**: The wallet does not have enough funds to complete the transaction.\ **Resolution**: Ensure sufficient funds are available before attempting the transaction. * **INTERNAL\_SERVER\_ERROR**\ **Description**: An unexpected server-side issue occurred.\ **Resolution**: Retry the request later and contact support if the issue persists. * **INVALID\_AMOUNT**\ **Description**: The amount specified in the transaction is invalid.\ **Resolution**: Check the transaction amount and ensure it is within the allowed range. * **INVALID\_CHIMONEY**\ **Description**: The specified`chimoney` object is invalid.\ **Resolution**: Verify the `chimoney` `id` or `chiref` and ensure it is correctly formatted. * **INVALID\_COUNTRY**\ **Description**: The specified country is invalid.\ **Resolution**: Verify that the country code is correct and supported. * **INVALID\_CURRENCY**\ **Description**: The specified currency is invalid.\ **Resolution**: Ensure that the currency code is correct and supported. * **INVALID\_EMAIL**\ **Description**: The specified email address is invalid.\ **Resolution**: Check the email format and ensure it complies with standard email formats. * **INVALID\_MOMOCODE**\ **Description**: The specified mobile money code is invalid.\ **Resolution**: Verify the mobile money code and ensure it is valid and supported. * **INVALID\_PHONE\_NUMBER**\ **Description**: The specified phone number is invalid.\ **Resolution**: Verify the phone number format and ensure it is correct. * **INVALID\_REQUEST**\ **Description**: The request is invalid.\ **Resolution**: Review the request parameters and ensure they comply with the API requirements. * **INVALID\_SIGNATURE**\ **Description**: The request signature is invalid.\ **Resolution**: Verify the signature and ensure it matches the one generated for the request. * **INVALID\_STATUS**\ **Description**: The specified status is invalid.\ **Resolution**: Ensure that the status value is valid and supported. * **LIMIT\_EXCEEDED**\ **Description**: The maximum cash out amount or transaction limit has been exceeded.\ **Resolution**: Check the limits and reduce the transaction amount or frequency. * **MIN\_AMOUNT\_NOT\_MET**\ **Description**: The minimum transaction amount has not been met.\ **Resolution**: Verify the transaction amount and ensure it meets the minimum requirement. * **MISSING\_FIELD**\ **Description**: A required field is missing.\ **Resolution**: Ensure all required fields are included in the request. * **NO\_TRANSACTION**\ **Description**: No transaction found.\ **Resolution**: Ensure the transaction ID is correct and exists in the system. * **NOT\_DEBITED**\ **Description**: The transaction has not been debited.\ **Resolution**: Verify the transaction status and try the operation again. * **NOT\_MEMBER**\ **Description**: The user is not a member of the required group or service.\ **Resolution**: Check the user’s membership status and ensure they meet the requirements. * **PAYMENT\_FAILED**\ **Description**: A payment operation failed.\ **Resolution**: Review the payment details and retry the operation. * **PAYOUT\_FAILED**\ **Description**: The payout operation failed.\ **Resolution**: Verify payout details and retry. Contact support if the issue persists. * **PERMISSION\_DENIED**\ **Description**: Permission is denied for the operation.\ **Resolution**: Verify user permissions and ensure they have the necessary access. * **PROFILE\_NOT\_FOUND**\ **Description**: The specified profile cannot be found.\ **Resolution**: Check the profile ID and ensure it exists. * **QUOTE\_EXPIRED**\ **Description**: The quote provided has expired.\ **Resolution**: Generate a new quote and retry the operation. * **QUOTE\_GENERATION\_FAILED**\ **Description**: Quote generation failed.\ **Resolution**: Verify the request parameters and try to generate the quote again. * **REDEEMED\_TRANSACTION**\ **Description**: The transaction has already been redeemed.\ **Resolution**: Check the transaction status and avoid re-redeeming. * **REDEMPTION\_FAILED**\ **Description**: Transaction redemption failed.\ **Resolution**: Review the redemption request and ensure it meets all requirements. * **REFUND\_FAILED**\ **Description**: Refund operation failed.\ **Resolution**: Verify refund details and ensure compliance with system requirements. * **SIMULATION\_FAILED**\ **Description**: Simulation of an operation failed.\ **Resolution**: Verify the simulation parameters and try again. * **SUBACCOUNT\_NOT\_FOUND**\ **Description**: The specified subaccount cannot be found.\ **Resolution**: Ensure the subaccount ID is correct and exists. * **TRANSACTION\_ERROR**\ **Description**: A general transaction error occurred.\ **Resolution**: Review transaction details and ensure they comply with system requirements. * **TRANSACTION\_NOT\_FOUND**\ **Description**: The specified transaction cannot be found.\ **Resolution**: Check the transaction ID and ensure it is correct. * **TRANSACTION\_STATUS\_ERROR**\ **Description**: There is an error with the transaction status.\ **Resolution**: Verify the transaction status and try to resolve the issue. * **TRANSACTION\_VERIFICATION\_FAILED**\ **Description**: Transaction verification failed.\ **Resolution**: Verify the transaction details and retry the operation. * **UNPAID\_TRANSACTION**\ **Description**: The transaction is unpaid.\ **Resolution**: Check the payment status and ensure it is processed. * **UNSUPPORTED\_CURRENCY**\ **Description**: The specified currency is not supported.\ **Resolution**: Use a supported currency and verify the currency code. * **USER\_NOT\_FOUND**\ **Description**: The specified user cannot be found.\ **Resolution**: Verify the user ID and ensure it exists in the system. * **VOUCHER\_ALREADY\_USED**\ **Description**: The voucher has already been used.\ **Resolution**: Check the voucher status and avoid using it again. * **VOUCHER\_INVALID**\ **Description**: The voucher is invalid.\ **Resolution**: Verify the voucher details and ensure it is valid. * **WALLET\_NOT\_FOUND**\ **Description**: No wallet found.\ **Resolution**: Verify the wallet ID and ensure it exists.