Virtual Account(UK/EU) Errors

TRANSACTION_INSUFFICIENT_FUNDS

Common Causes

The account does not have sufficient funds to complete the transaction.

Troubleshooting steps

Check the available balance on the Virtual Account.

Consider funding the Virtual Account.

Try again when there is sufficient balance on the Virtual Account.

Try again with a lower transaction amount.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_INSUFFICIENT_FUNDS",
5 "error_message": "There are insufficient funds to complete the transaction",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_AMOUNT_EXCEEDED

Common Causes

The transaction amount exceeds the allowed threshold configured for this client.

Troubleshooting steps

Contact your Plaid Account Manager for your compliance rules.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_AMOUNT_EXCEEDED",
5 "error_message": "Transaction amount exceeds the allowed threshold for this client",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_ON_SAME_ACCOUNT

Common Causes

The recipient bank account details on the transaction are incorrect and refer to the source Virtual Account.

Troubleshooting steps

Confirm that the bank account details do not route back to the Virtual Account.

Try again with a different recipient bank account.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_ON_SAME_ACCOUNT",
5 "error_message": "Payment to the same account is not allowed",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_CURRENCY_MISMATCH

Common Causes

The currency on the recipient bank account is different than that of the wallet.

Troubleshooting steps

Check the currency of the Virtual Account

Confirm that the provided bank account details accepts the same currency as the Virtual Account.

Try again with a different recipient bank account.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_CURRENCY_MISMATCH",
5 "error_message": "The currency between the wallet and recipient account is different",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_IBAN_INVALID

Common Causes

The provided IBAN on the recipient bank account is invalid.

Troubleshooting steps

Check that a valid IBAN was provided in the request.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_IBAN_INVALID",
5 "error_message": "The provided IBAN is invalid",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_BACS_INVALID

Common Causes

The provided Account Number and/or Sort Code on the recipient account is invalid.

Troubleshooting steps

Check that a valid Account Number was provided in the request.

Check that a valid Sort Code was provided in the request.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_BACS_INVALID",
5 "error_message": "The provided BACS account number and/or sort code is invalid",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_FAST_PAY_DISABLED

Common Causes

The provided Sort Code on the recipient account is not enabled for Faster Payments. GBP transactions out of Virtual Accounts in GB are made via the Faster Payments rail.

Troubleshooting steps

Check with the bank of the recipient bank account that Faster Payments has been enabled.

Try again using a different recipient bank account if Faster Payments is not supported.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_FAST_PAY_DISABLED",
5 "error_message": "The recipient sort code is not enabled for faster payments",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

TRANSACTION_EXECUTION_FAILED

Common Causes

The transaction failed to execute due to an internal error.
The transaction might have been declined by the receiving bank.
Technical issues with the payment processor.

Troubleshooting steps

Check the request body against the API reference for /wallet/transaction/execute

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "TRANSACTION_EXECUTION_FAILED",
5 "error_message": "There was a problem executing the transaction. Please retry.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

NONIDENTICAL_REQUEST

Common Causes

The request parameters have changed compared to the original request with the same idempotency key.

Troubleshooting steps

Check that idempotency keys are not being reused for different requests.

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "NONIDENTICAL_REQUEST",
5 "error_message": "Request body does not match previous request with this idempotency key",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

Was this helpful?

REQUEST_CONFLICT

Common Causes

The original request is still processing and has not completed.
A network or system issue caused a delay in processing the original request, resulting in a conflict when the new request is sent.

Troubleshooting steps

Wait and retry the request again

API error response
1http code 400
2{
3 "error_type": "TRANSACTION_ERROR",
4 "error_code": "REQUEST_CONFLICT",
5 "error_message": "Original request is still processing",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}