AccountHolderDetails

This object contains detailed information on the account holder.

Field Type Required Description
address Address (error) An account holder's address.
bankAccountDetails Array (error)

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 (error)

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 (tick) An account holder's email.
fullPhoneNumber
String (tick) 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 (error)

Individual details of the account holder.

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

merchantCategoryCode
String (error)

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 (error)

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 (error)

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

Limitations:

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

  Value String (error)

Information value. Example: value = 'US'

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

webAddress
String (error) A valid URL.