--- title: "Virtual Account Errors" source_url: https://docs.rapyd.net/en/virtual-account-errors.html lang: en --- # Virtual Account Errors The following error codes and messages appear in REST responses when an error prevents completion of the request. | Virtual Account Errors | | --- | | **Error code:** ERROR_GET_ISSUING **Message:** The request tried to retrieve a bank account object issued to a wallet, but the ID of the object was not recognized. The request was rejected. Corrective action: Provide the ID of a valid issued bank account object, a string starting with **issuing_**. **Explanation:** You provided an invalid ID for the virtual account or the virtual account does not exist. Ensure that the ID is correct. **Error Example:** `get /v1/virtual_accounts/virtualaccount_12345aaaabbb` **Correct Example:** ```json get /v1/virtual_accounts/issuing_12345abcd ``` | | **Error code:** ERROR_GET_ISSUING_TRANSACTION **Message:** 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](https://docs.rapyd.net/en/retrieve-virtual-account-history.md "Retrieve Virtual Account History"). **Explanation:** The specific transaction associated with the virtual account could not be found. Verify that both the virtual account ID and the transaction UUID are correct. **Correct Example:** ```json get /v1/virtual_accounts/issuing_12345abcd/transactions/e673ef1c-965d-480e-9770-13505ac4cd06 ``` | | **Error code:** ERROR_ISSUE_BANK_ACCOUNT_NUMBER_WALLET_CONTACT_DATA_MISSING - () **Message:** The request tried to issue a bank account number to a wallet, but value(s) are missing for these field(s): {`missing_field_name_1`,`missing_field_name_2`}. The request was rejected. Corrective action: Run the Update Wallet Contact API request to add values for the fields that are listed in this message. For more information, see the API Reference. **Explanation:** The wallet contact is missing required personal information, such as `first_name` or `last_name`. You must update the contact details before issuing a virtual account. **Correct Example:** ```json post /v1/ewallets/ewallet_12345abcd/contact { "first_name": "Jane", "last_name": "Doe", "email": "jane.doe@example.com", "contact_type": "personal", "address": { "line_1": "123 Main St", "city": "Reykjavik", "country": "IS", "zip": "101" } } ``` | | **Error code:** ERROR_ISSUE_BANK_ACCOUNT_NUMBER_WALLET_DATA_MISSING **Message:** The request tried to issue a bank account number to a wallet, but required data in the wallet is missing. The request was rejected. Corrective action: Use Update Wallet to add the fields listed at the end of the error code. For more information, see the API Reference. **Explanation:** The wallet object itself is missing mandatory metadata or configuration required for issuing accounts. Update the wallet with the necessary details. **Correct Example:** ```json post /v1/ewallets/ewallet_12345abcd { "contact": { "email": "jane.doe@rapyd.net" } } ``` | | **Error code:** ERROR_ISSUING_BANK_ACCOUNT_COUNTRY_CURRENCY_MISMATCH **Message:** The request tried to issue a virtual account number to a wallet, but the currency is not supported for the country provided. The request was rejected. Corrective action: Contact Client Support. **Explanation:** The combination of `country` and `currency` you provided is not a valid pair for virtual accounts in the Rapyd system. **Correct Example:** ```json { "currency": "EUR", "country": "DE", "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861" } ``` | | **Error code:** ERROR_ISSUING_DEPOSIT **Message:** The request tried to simulate a deposit to a bank account number that was issued to a wallet in the sandbox, but the bank account was not found. The request was rejected. Corrective action: For `issued_bank_account`, use the ID of a bank account number that was issued to a wallet. The ID is a string starting with **issuing_**. **Explanation:** You are trying to simulate a deposit to a non-existent sandbox account. Provide a valid `issued_bank_account` ID. **Correct Example:** ```json { "issued_bank_account": "issuing_59fd68cb3837f632abdcb5ddaa75045b", "amount": 100, "currency": "USD" } ``` | | **Error code:** ERROR_ISSUING_VIRTUAL_ACCOUNT_REQUEST_NOT_SUPPORTED **Message:** The request attempted to issue a virtual account to a wallet, but this request is not supported. The request was rejected. Corrective action: Contact Rapyd Support. **Explanation:** You are attempting an operation that is not enabled for your account type. Contact Rapyd Support. | | **Error code:** ERROR_ISSUING_VIRTUAL_ACCOUNT_WITH_TRANSACTIONS_ON_HOLD_CANNOT_BE_CLOSED **Message:** The request tried to close a virtual account, but virtual account transactions were on hold for compliance review. The request was rejected. Corrective action: Contact Rapyd Support. **Explanation:** You cannot close this account because there are pending transactions undergoing compliance checks. | | **Error code:** INVALID_EWALLET_TOKEN **Message:** The request tried to issue a virtual account number to a wallet, but the wallet ID was missing from the request. The request was rejected. Corrective action: In the `ewallet` field, provide the ID of a valid wallet, a string starting with **ewallet_**. **Explanation:** You forgot to specify the target `ewallet` ID in your request. **Error Example:** `{"currency":"USD","country":"US"}` **Correct Example:** ```json { "ewallet": "ewallet_b16ab040e51deda7f6a786862bd3fe7b", "currency": "USD", "country": "US" } ``` |