Wallet Transaction Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
Error Code | Description |
|---|---|
CANCEL_TRANSACTION_ERROR | The request tried to cancel a wallet transaction, but the transaction was not found. The request was rejected. Corrective action: Provide a valid transaction ID. |
COMPLETE_TRANSACTION_ERROR | The request tried to complete a wallet transaction, but the transaction was not found. The request was rejected. Corrective action: Provide a valid transaction ID. |
ERROR_AMOUNT_EXCEEDS_DESTINATION_EWALLET_LIMIT | The request attempted an operation that puts funds in a wallet, but the amount exceeds the limit set for that wallet for funds of that currency. The request was rejected. Corrective action: Transfer an amount that does not put the destination wallet over its limit for that currency. |
ERROR_AMOUNT_EXCEEDS_DESTINATION_EWALLET_LIMIT_BY_MERCHANT_CONTROLLED_PARAMETERS | The request tried to transfer funds to a wallet, but the amount would cause the wallet to exceed its balance limit. The request was rejected. Corrective action: Remove money from the wallet before trying to add more, or deposit a different amount. To raise the balance limit, you can complete the customer identity verification process. |
ERROR_BALANCE_TRANSFER | The request tried to convert currency and transfer it to another wallet, but the destination wallet was disabled. The request was rejected. Corrective action: None. Determine why the destination wallet was disabled. |
ERROR_CARD_AUTHENTICATION_FAILURE | The request created a card payment that requires 3DS authentication, but the authentication was not completed in the time allowed. The payment was canceled. Corrective action: None. Create another payment. |
ERROR_CREATE_TRANSFER | The request tried to create a transfer of funds from one wallet to another, but one wallet was not found. The request was rejected. Corrective action: Provide valid IDs for both wallets. |
ERROR_EWALLET_ACCOUNT_LIMIT_EXCEEDS_CURRENT_BALANCE | The request tried to create or update a limit on a wallet currency account, but the limit offered was lower than the amount of currency in the account. The request was rejected. Corrective action: Set a limit that is less than or equal to the amount currently in the account. |
ERROR_EWALLET_LIMIT_NOT_VALID | The request tried to create or update a limit on a wallet currency account, but the limit was not valid. The request was rejected. Corrective action: Use a positive number. |
ERROR_EWALLET_TRANSFER_DESTINATION_EWALLET_DISABLED | The request tried to transfer funds to a wallet, but the wallet was disabled. The request was rejected. Corrective action: Enable the destination wallet. |
ERROR_EWALLET_TRANSFER_ID_NOT_FOUND | The request tried to set a response to a transfer between wallets, but the ID of the transfer transaction was not found. The request was rejected. Corrective action: Use a valid transaction ID. |
ERROR_EWALLET_TRANSFER_SOURCE_EWALLET_DISABLED | The request tried to transfer funds from a wallet, but the wallet was disabled. The request was rejected. Corrective action: Enable the source wallet. |
ERROR_EWALLET_TRANSFER_SOURCE_EWALLET_NOT_FOUND | The request tried to transfer funds from a wallet, but the wallet was not found. The request was rejected. Corrective action: Use the correct phone number for the source wallet. |
ERROR_GET_ACCOUNT_FUNDS_DETAILS | The request tried to retrieve details of a transaction, but the transaction was not found. The request was rejected. Corrective action: Provide a valid transaction ID, which is a UUID. |
ERROR_GET_ISSUING_TRANSACTION | The request tried to retrieve a transfer to a virtual account, but the transaction was not found. The request was rejected. Corrective action: In the path, use the ID of the Virtual Account Number object that was issued to the wallet, which is a string starting with 'issuing_'. Also use the ID of the transaction, which is a UUID. To find the transaction ID, use 'Retrieve Virtual Account History'. |
ERROR_GET_TRANSACTION | The request tried to retrieve a transaction, but the transaction was not found. The request was rejected. Corrective action: Use the ID of a wallet that has not been closed, and the ID of a transaction that is associated with that wallet. |
ERROR_REMOVE_ACCOUNT_LIMIT | The request tried to remove a limit on a wallet account, but the account did not have the indicated limit. The request was rejected. Corrective action: None. Determine why an attempt was made to remove a non-existent limit. |
ERROR_RESPONSE_TRANSFER | The request tried to accept, reject or cancel a transfer that was previously declined by the transferee. The request was rejected. Corrective action: If the intent was to accept, create a new transfer. Otherwise, determine why a transfer response was attempted on a declined transaction. |
ERROR_TRANSFER_FUNDS_DESTINATION_AND_SOURCE_CANNOT_BE_THE_SAME | The request tried to transfer funds, but the source was the same as the destination. The request was rejected. Corrective action: Set 'source_ewallet' and 'destination_ewallet' to the IDs of two different wallets. |
ERROR_TRANSFER_RESPONSE_INVALID_DETAILS | The request tried to accept, reject or cancel a transfer between wallets, but the transaction was not found. The request was rejected. Corrective action: If the intent was to accept, create a new transfer. |
ERROR_TRANSFER_RESPONSE_PREVIOUSLY_CANCELED | The request tried to accept, reject or cancel a transfer that was previously canceled by the sender. The request was rejected. Corrective action: If the intent was to accept, create a new transfer. Otherwise, determine why a transfer response was attempted on a canceled transaction. |
ERROR_TRANSFER_RESPONSE_PREVIOUSLY_DECLINED | The request tried to accept, reject or cancel a transfer that was previously declined by the transferee. The request was rejected. Corrective action: If the intent was to accept, create a new transfer. Otherwise, determine why a transfer response was attempted on a declined transaction. |
ERROR_UPDATE_FUNDS | The request tried to add funds to or remove funds from a wallet, but the wallet was not found. The request was rejected. Corrective action: Set 'ewallet' to the ID of a valid wallet that has not been blocked or deleted. The ID is a string starting with 'ewallet_'. |
INVALID_TRANSACTION_ID | The request tried to retrieve a transaction, but the transaction was not found. The request was rejected. Corrective action: Verify that the transaction ID is correct and that it is associated with the wallet specified in 'token'. |
INVALID_TRANSFER_DETAILS | The request tried to transfer funds from a wallet to another wallet, but the input parameters were not valid. The request was rejected. Corrective action: For 'currency', use the ISO 4217 code. For 'source_ewallet' and 'destination_ewallet', use the IDs of valid wallets. |
INVALID_TRANSFER_STATUS | The request tried to set a response to a transfer between wallets, but the status was not recognized. The request was rejected. Corrective action: Set 'status' to one of the following values: 'accept', 'decline', 'cancel'. |
NOT_ENOUGH_FUNDS | The request attempted an operation that requires funds in a specific currency, but there were not sufficient funds in that currency. The request was rejected. Corrective action: Transfer funds to the wallet in the required currency. |
TRANSFER_DESTINATION_USER_ID_IS_INVALID | The request tried to transfer funds to a wallet, but the destination wallet was not found. The request was rejected. Corrective action: Use the correct wallet ID for the destination wallet. |
WALLET_TO_WALLET_TRANSFER_EXPIRED | The request tried to respond to a wallet-to-wallet transfer, but the transaction had already expired. The request was rejected. Corrective action: Create a new wallet-to-wallet transfer. |
WALLET_TRANSFER_NOT_ALLOWED_FOR_COLLECT_WALLET | The request tried to transfer funds from a wallet to wallet, but one of the wallets was a client wallet of type 'collect' and this action is not allowed. The request was rejected. Corrective action: None. |