Bank Payouts / Request a payout / Payout error codes

Payout error codes

Last updated: 14th July 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 Code	Description
`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.