Skip to content

Payout error codes

Last updated: 9th August 2022

If your payout request is unsuccessful, you will receive an error object in the response containing one or several of the following error_codes.

Error CodeDescription

account_holder_billing_address_address_line1_invalid_format

Line 1 of the account holder's billing address has an invalid format.

account_holder_billing_address_address_line1_invalid_type

Line 1 of the account holder's billing address has an invalid type.

account_holder_billing_address_address_line1_required

Line 1 of the account holder's billing address is required, but has not been provided.

account_holder_billing_address_address_line1_too_long

Line 1 of the account holder's billing address is too long.

account_holder_billing_address_address_line1_too_short

Line 1 of the account holder's billing address is too short.

account_holder_billing_address_address_line2_invalid_format

Line 2 of the account holder's billing address has an invalid format.

account_holder_billing_address_address_line2_invalid_type

Line 2 of the account holder's billing address has an invalid type.

account_holder_billing_address_address_line2_required

Line 2 of the account holder's billing address is required, but has not been provided.

account_holder_billing_address_address_line2_too_long

Line 2 of the account holder's billing address is too long.

account_holder_billing_address_address_line2_too_short

Line 2 of the account holder's billing address is too short.

account_holder_billing_address_city_invalid_format

The account holder's billing address city has an invalid format.

account_holder_billing_address_city_invalid_type

The account holder's billing address city has an invalid type.

account_holder_billing_address_city_required

The account holder's billing address city is required, but has not been provided.

account_holder_billing_address_city_too_long

The account holder's billing address city is too long.

account_holder_billing_address_city_too_short

The account holder's billing address city is too short.

account_holder_billing_address_country_invalid_format

The account holder's billing address country has an invalid format.

account_holder_billing_address_country_invalid_type

The account holder's billing address country has an invalid type.

account_holder_billing_address_country_required

The account holders billing address country is required, but has not been provided.

account_holder_billing_address_country_too_long

The account holder's billing address country is too long.

account_holder_billing_address_country_too_short

The account holder's billing address country is too short.

account_holder_billing_address_state_invalid_format

The account holder's billing address state has an invalid format.

account_holder_billing_address_state_invalid_type

The account holder's billing address state has an invalid type.

account_holder_billing_address_state_required

The account holder's billing address state is required, but has not been provided.

account_holder_billing_address_state_too_long

The account holder's billing address state is too long.

account_holder_billing_address_state_too_short

The account holder's billing address state is too short.

account_holder_billing_address_zip_invalid_format

The account holder's billing address ZIP has an invalid format.

account_holder_billing_address_zip_invalid_type

The account holder's billing address ZIP has an invalid type.

account_holder_billing_address_zip_required

The account holder's billing address ZIP is required, but has not been provided.

account_holder_billing_address_zip_too_long

The account holder's billing address ZIP is too long.

account_holder_billing_address_zip_too_short

The account holder's billing address ZIP is too short.

account_holder_company_name_invalid_format

The account holder's company name has an invalid format.

account_holder_company_name_invalid_type

The account holder's company name has an invalid type.

account_holder_company_name_required

The account holder's company name is required, but has not been provided.

account_holder_company_name_too_long

The account holder's company name is too long.

account_holder_company_name_too_short

The account holder's company name is too short.

account_holder_country_of_birth_invalid_format

The account holder's country of birth has an invalid format.

account_holder_country_of_birth_invalid_type

The account holder's country of birth has an invalid type.

account_holder_country_of_birth_required

The account holder's country of birth is required, but has not been provided.

account_holder_country_of_birth_too_long

The account holder's country of birth is too long.

account_holder_country_of_birth_too_short

The account holder's country of birth is too short.

account_holder_date_of_birth_invalid_format

The account holder's date of birth has an invalid format.

account_holder_date_of_birth_invalid_type

The account holder's date of birth has an invalid type.

account_holder_date_of_birth_required

The account holder's date of birth is required.

account_holder_date_of_birth_too_long

The account holder's date of birth is too long.

account_holder_date_of_birth_too_short

The account holder's date of birth is too short.

account_holder_email_invalid_format

The account holder's email address has an invalid format.

account_holder_email_invalid_type

The account holder's email address has an invalid type.

account_holder_email_required

The account holder's email address is required, but has not been provided.

account_holder_email_too_long

The account holder's email address is too long.

account_holder_email_too_short

The account holder's email address is too short.

account_holder_first_name_invalid_format

The account holder's first name has an invalid format.

account_holder_first_name_invalid_type

The account holder's first name has an invalid type.

account_holder_first_name_required

The account holder's first name is required, but has not been provided.

account_holder_first_name_too_long

The account holder's first name is too long.

account_holder_first_name_too_short

The account holder's first name is too short.

account_holder_identification_issuing_country_invalid_format

The account holder's identification issuing country has an invalid format.

account_holder_identification_issuing_country_invalid_type

The account holder's identification issuing country has an invalid type.

account_holder_identification_issuing_country_required

The account holder's identification issuing country is required, but has not been provided.

account_holder_identification_issuing_country_too_long

The account holder's identification issuing country is too long.

account_holder_identification_issuing_country_too_short

The account holder's identification issuing country is too short.

account_holder_identification_number_invalid_format

The account holder's identification number has an invalid format.

account_holder_identification_number_invalid_type

The account holder's identification number has an invalid type.

account_holder_identification_number_too_long

The account holder's identification number is too long.

account_holder_identification_number_too_short

The account holder's identification number is too short.

account_holder_identification_type_invalid_format

The account holder's identification type has an invalid format.

account_holder_identification_type_invalid_option

The account holder's identification type has an invalid option.

account_holder_identification_type_invalid_type

The account holder's identification type has an invalid type.

account_holder_identification_type_required

The account holder's identification type is required, but has not been provided.

account_holder_identification_type_too_long

The account holder's identification type is too long.

account_holder_identification_type_too_short

The account holder's identification type is too short.

account_holder_last_name_invalid_format

The account holder's last name has an invalid format.

account_holder_last_name_invalid_type

The account holder's last name has an invalid type.

account_holder_last_name_required

The account holder's last name is required, but has not been provided.

account_holder_last_name_too_long

The account holder's last name is too long.

account_holder_last_name_too_short

The account holder's last name is too short.

account_holder_phone_country_code_invalid_format

The account holder's phone country code has an invalid format.

account_holder_phone_country_code_invalid_type

The account holder's phone country code has an invalid type.

account_holder_phone_country_code_required

The account holder's phone country code is required, but has not been provided.

account_holder_phone_country_code_too_long

The account holder's phone country code is too long.

account_holder_phone_country_code_too_short

The account holder's phone country code is too short.

account_holder_phone_number_invalid_format

The account holder's phone country code has an invalid format.

account_holder_phone_number_invalid_type

The account holder's phone country code has an invalid type.

account_holder_phone_number_required

The account holder's phone number is required, but has not been provided.

account_holder_phone_number_too_long

The account holder's phone number is too long.

account_holder_phone_number_too_short

The account holder's phone number is too short.

account_holder_residential_status_invalid_format

The account holder's residential status has an invalid format.

account_holder_residential_status_invalid_option

The account holder's residential status has an invalid option.

account_holder_residential_status_invalid_type

The account holder's residential status has an invalid type.

account_holder_residential_status_required

The account holder's residential status is required, but has not been provided.

account_holder_residential_status_too_long

The account holder's residential status is too long.

account_holder_residential_status_too_short

The account holder's residential status is too short.

account_holder_residential_status_invalid_format

The account holder's residential status has an invalid format.

account_holder_residential_status_invalid_option

The account holder's residential status has an invalid option.

account_holder_residential_status_invalid_type

The account holder's residential status has an invalid type.

account_holder_residential_status_required

The account holder's residential status is required, but has not been provided.

account_holder_residential_status_too_long

The account holder's residential status is too long.

account_holder_residential_status_too_short

The account holder's residential status is too short.

account_holder_tax_id_invalid_format

The account holder's tax ID has an invalid format.

account_holder_tax_id_invalid_type

The account holder's tax ID has an invalid type.

account_holder_tax_id_required

The account holder's tax ID is required, but has not been provided.

account_holder_tax_id_too_long

The account holder's tax ID is too long.

account_holder_tax_id_too_short

The account holder's tax ID is too short.

account_holder_type_invalid_format

The account holder type has an invalid format.

account_holder_type_invalid_option

The account holder type has an invalid option.

account_holder_type_invalid_type

The account holder type has an invalid type.

account_holder_type_required

The account holder type is required, but has not been provided.

account_holder_type_too_long

The account holder type is too long.

account_holder_type_too_short

The account holder type is too short.

account_number_invalid

The account number is invalid.

account_number_invalid_format

The account number has an invalid format.

account_number_invalid_type

The account number has an invalid type.

account_number_required

The account number is required, but has not been provided.

account_number_too_long

The account number is too long.

account_number_too_short

The account number is too short.

account_type_invalid_format

The account type has an invalid format.

account_type_invalid_option

The account type has an invalid option.

account_holder_residential_status_invalid_type

The account holder's residential status has an invalid type.

account_holder_residential_status_required

The account holder's residential status is required, but has not been provided.

account_holder_residential_status_too_long

The account holder's residential status is too long.

account_holder_residential_status_too_short

The account holder's residential status is too short.

account_holder_residential_status_invalid_format

The account holder's residential status has an invalid format.

account_holder_residential_status_invalid_option

The account holder's residential status has an invalid option.

account_holder_residential_status_invalid_type

The account holder's residential status has an invalid type.

account_holder_residential_status_required

The account holder's residential status is required, but has not been provided.

account_holder_residential_status_too_long

The account holder's residential status is too long.

account_holder_residential_status_too_short

The account holder's residential status is too short.

account_holder_tax_id_invalid_format

The account holder's tax ID has an invalid format.

account_holder_tax_id_invalid_type

The account holder's tax ID has an invalid type.

account_holder_tax_id_required

The account holder's tax ID is required, but has not been provided.

account_holder_tax_id_too_long

The account holder's tax ID is too long.

account_holder_tax_id_too_short

The account holder's tax ID is too short.

account_holder_type_invalid_format

The account holder type has an invalid format.

account_holder_type_invalid_option

The account holder type has an invalid option.

account_holder_type_invalid_type

The account holder type has an invalid type.

account_holder_type_required

The account holder type is required, but has not been provided.

account_holder_type_too_long

The account holder type is too long.

account_holder_type_too_short

The account holder type is too short.

account_number_invalid

The account number is invalid.

account_number_invalid_format

The account number has an invalid format.

account_number_invalid_type

The account number has an invalid type.

account_number_required

The account number is required, but has not been provided.

account_number_too_long

The account number is too long.

account_number_too_short

The account number is too short.

account_type_invalid_format

The account type has an invalid format.

account_type_invalid_option

The account type has an invalid option.

account_type_invalid_type

The account type has an invalid type.

account_type_too_long

The account type is too long.

account_type_too_short

The account type is too short.

amount_invalid

The amount is invalid.

amount_not_supported_on_route

The amount is not supported.

balance_reservation_insufficient_funds

There are insufficient funds in the account to cover the amount.

bank_address_address_line1_invalid_format

Line 1 of the bank address has an invalid format.

bank_address_address_line1_invalid_type

Line 1 of the bank address has an invalid type.

bank_address_address_line1_required

Line 1 of the bank address is required, but has not been provided.

bank_address_address_line1_too_long

Line 1 of the bank address is too long.

bank_address_address_line1_too_short

Line 1 of the bank address is too short.

bank_address_address_line2_invalid_format

Line 2 of the bank address has an invalid format.

bank_address_address_line2_invalid_type

Line 2 of the bank address has an invalid type.

bank_address_address_line2_required

Line 2 of the bank address is required, but has not been provided.

bank_address_address_line2_too_long

Line 2 of the bank address is too long.

bank_address_address_line2_too_short

Line 2 of the bank address is too short.

bank_address_city_invalid_format

The bank address city has an invalid format.

bank_address_city_invalid_type

The bank address city has an invalid type.

bank_address_city_required

The bank address city is required, but has not been provided.

bank_address_city_too_long

The bank address city is too long.

bank_address_city_too_short

The bank address city is too short.

bank_address_country_invalid_format

The bank address country has an invalid format.

bank_address_country_invalid_type

The bank address country has an invalid type.

bank_address_country_required

The bank address country is required, but has not been provided.

bank_address_country_too_long

The bank address country is too long.

bank_address_country_too_short

The bank address country is too short.

bank_address_state_invalid_format

The bank address state has an invalid format.

bank_address_state_invalid_type

The bank address state has an invalid type.

bank_address_state_required

The bank address state is required, but has not been provided.

bank_address_state_too_long

The bank address state is too long.

bank_address_state_too_short

The bank address state is too short.

bank_address_zip_invalid_format

The bank address ZIP has an invalid format.

bank_address_zip_invalid_type

The bank address ZIP has an invalid type.

bank_address_zip_required

The bank address ZIP is required, but has not been provided.

bank_address_zip_too_long

The bank address ZIP is too long.

bank_address_zip_too_short

The bank address ZIP is too short.

bank_branch_invalid_format

The bank branch has an invalid format.

bank_branch_invalid_type

The bank branch has an invalid type.

bank_branch_required

The bank branch is required, but has not been provided.

bank_branch_too_long

The bank branch is too long.

bank_branch_too_short

The bank branch is too short.

bank_code_invalid_format

The bank code has an invalid format.

bank_code_invalid_type

The bank code has an invalid type.

bank_code_too_long

The bank code is too long.

bank_code_too_short

The bank code is too short.

bank_details_invalid

The bank details are invalid.

bank_name_invalid_format

The bank name has an invalid format.

bank_name_invalid_type

The bank name has an invalid type.

bank_name_required

The bank name is required, but has not been provided.

bank_name_too_long

The bank name is too long.

bank_name_too_short

The bank name is too short.

bank_not_found

The bank has not been found.

bank_not_supported

The bank is not supported.

bban_invalid_format

The Basic Bank Account Number (BBAN) has an invalid format.

bban_invalid_type

The BBAN has an invalid type.

bban_required

The BBAN is required, but has not been provided.

bban_too_long

The BBAN is too long.

bban_too_short

The BBAN is too short.

branch_code_invalid_format

The branch code has an invalid format.

branch_code_invalid_type

The branch code has an invalid type.

branch_code_too_long

The branch code is too long.

branch_code_too_short

The branch code is too short.

country_invalid

The country is invalid.

country_invalid_format

The country has an invalid format.

country_invalid_type

The country has an invalid type.

country_not_supported

The country is not supported.

country_required

The country is required, but has not been provided.

country_too_long

The country is too long.

country_too_short

The country is too short.

currency_invalid

The currency is invalid.

currency_invalid_format

The currency has an invalid format.

currency_invalid_type

The currency has an invalid type.

currency_not_supported

The currency is not supported.

currency_required

The currency is required, but has not been provided.

currency_too_long

The currency is too long.

currency_too_short

The currency is too short.

customer_email_invalid_format

The customer's email address has an invalid format.

customer_email_invalid_type

The customer's email address has an invalid type.

customer_email_required

The customer's email address is required.

customer_email_too_long

The customer's email address is too long.

customer_email_too_short

The customer's email address is too short.

customer_id_invalid_format

The customer's ID has an invalid format.

customer_id_invalid_type

The customer's ID has an invalid type.

customer_id_required

The customer's ID is required, but has not been provided.

customer_id_too_long

The customer's ID is too long.

customer_id_too_short

The customer's ID is too short.

customer_name_invalid_format

The customer's name has an invalid format.

customer_name_invalid_type

The customer's name has an invalid type.

customer_name_required

The customer's name is required, but has not been provided.

customer_name_too_long

The customer's name is too long.

customer_name_too_short

The customer's name is too short.

desired_value_date_not_achievable

The value date set is not achievable.

destination_country_not_supported

The destination country is not supported.

destination_account_number_invalid

The destination bank account number is invalid.

destination_bank_details_invalid

The destination bank details are invalid.

destination_bank_not_found

The destination bank could not be found.

destination_bank_not_supported

The destination bank is not supported.

destination_country_invalid

The destination country is invalid.

destination_country_not_supported

The destination country is not supported.

destination_country_required

The destination country is required, but has not been provided.

destination_swift_iban_country_code_mismatch

There is a mismatch between the SWIFT code / IBAN and the country code.

iban_invalid_format

The IBAN has an invalid format.

iban_invalid_type

The IBAN has an invalid type.

iban_required

The IBAN is required, but has not been provided.

iban_too_long

The IBAN is too long.

iban_too_short

The IBAN is too short.

processing_error

There has been a processing error.

quote_expired

Your quote has expired.

quote_not_found

The quote could not be found.

sender_address_city_required

The city of the sender's address is required, but has not been provided.

sender_address_line1_required

The first line of the sender's address is required, but has not been provided.

sender_country_invalid

The sender's country is invalid.

sender_country_required

The sender's country is required, but has not been provided.

sender_first_name_required

The sender's first name is required, but has not been provided.

sender_last_name_required

The sender's last name is required, but has not been provided.

sender_name_required

The sender's name is required, but has not been provided.

sender_reference_required

The sender's reference is required, but has not been provided.

sender_required

A sender is required, but has not been provided.

source_amount_invalid

The source amount is invalid.

swift_bic_invalid_format

The SWIFT / BIC has an invalid format.

swift_bic_invalid_type

The SWIFT / BIC has an invalid type.

swift_bic_required

The SWIFT / BIC is required, but has not been provided.

swift_bic_too_long

The SWIFT / BIC is too long.

swift_bic_too_short

The SWIFT / BIC is too short.

swift_iban_country_code_mismatch

There is a mismatch between the SWIFT / BIC and the country code.