Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

AccountHolderDetails

This object contains detailed information on the account holder.

Field Type Required Description
address Address -x- An account holder's address.
bankAccountDetails Array -x-

This array includes one or more BankAccountDetail objects.

Bank account validations differ per country and currency. For more information, see Bank account check.

businessDetails BusinessDetails -x-

Contains detailed information on the business type.

When being used in a /createAccountholder request, include either businessDetails or individualDetails , depending on the legalEntity.

email String -white_check_mark- An account holder's email.
fullPhoneNumber String -white_check_mark- The full phone number is a string handled as a landline phoneType (e.g. "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344").
individualDetails IndividualDetails -x-

Individual details of the account holder.

When being used in a /createAccountholder request, include either businessDetails or individualDetails , depending on the legalEntity .

merchantCategoryCode String -x-

Merchant category code.

If you do not specify the merchantCategoryCode in the request, we will derived in from the Marketplace (configured by Adyen).

metadata Object -x-

Metadata consists of entries, each of which includes the key and value.

This field takes the following children:

  • Key
  • Value

Limitations:

  • Error "177", "Metadata size exceeds limit"
Key String -x-

Key for the information to be provided. Example: key = 'storeCountry'

Limitations:

Error "178", "Metadata key size exceeds limit"

Value String -x-

Information value. Example: value = 'US'

Maximum length: 80 characters, value is truncated to 80 characters with '...' appended to it.

webAddress String -x- A valid URL.