Documentación

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:

get /v1/virtual_accounts/issuing_12345abcd

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 .

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:

get /v1/virtual_accounts/issuing_12345abcd/transactions/e673ef1c-965d-480e-9770-13505ac4cd06

ERROR_ISSUE_BANK_ACCOUNT_NUMBER_WALLET_CONTACT_DATA_MISSING - (<names of missing fields>)

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:

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_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:

post /v1/ewallets/ewallet_12345abcd
{
    "contact": {
        "email": "jane.doe@rapyd.net"
    }
}

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:

{
    "currency": "EUR",
    "country": "DE",
    "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861"
}

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:

{
    "issued_bank_account": "issuing_59fd68cb3837f632abdcb5ddaa75045b",
    "amount": 100,
    "currency": "USD"
}

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_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.

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:

{
    "ewallet": "ewallet_b16ab040e51deda7f6a786862bd3fe7b",
    "currency": "USD",
    "country": "US"
}