ACCOUNT_HOLDER_VERIFICATION

This notification is triggered when some events occur during account holder verification. For more information, refer to  KYC verification checks .

Common fields

The table below lists the fields that are present in each Adyen MarketPay notification and provide general information about the event that triggered this notification.

Name Type Returned by default Description
eventType String (tick)

This notification event's type.

For this event, it is ACCOUNT_HOLDER_VERIFICATION.

eventDate DateTime (tick)

NEW IN V4 The date and time when an event has been completed.

executingUserKey String (tick)

A user or process that has triggered the notification.

live Boolean (tick)

Informs about the origin of the notification:

  • true: the notification originated from the live environment.
  • false: the notification originated from the test environment.
pspReference String (tick) PSP Reference of the notification.
content Object (tick)

Notification message content, which is specific for each notification type.

For the detailed description of its structure, see the table below.

Content field structure

The content field of this notification contains the following elements.

Name Type Returned by default Description
accountHolderCode    String (tick)

A code identifying the account holder.

shareholderCode

  
 String (error)

Shareholder code for verified shareholders.

Returned if the current verification has been performed for a shareholder.

bankAccountUUID

String (error)

A bank ID represented by a unique string value.

Returned if the current verification has been performed for a bank account.

verificationType

Enum (tick)

A verification type.

Possible values:
  • COMPANY_VERIFICATION
  • IDENTITY_VERIFICATION
  • PASSPORT_VERIFICATION
  • BANK_ACCOUNT_VERIFICATION

For more information, refer to Verification checks.

verificationStatus Enum (tick)

A verification status.

Possible values:
  • PASSED
  • FAILED
  • PENDING
  • INVALID_DATA
  • AWAITING_DATA
  • DATA_PROVIDED
  • RETRY_LIMIT_REACHED

For more information, refer to Verification checks.

statusSummary KYCCheckSummary (tick)

NEW IN V4 A summary of the verification status.

Code example: Failed/invalid data status

{
   "eventType":"ACCOUNT_HOLDER_VERIFICATION",
   "eventDate":"2018-04-30T14:00:54+02:00",
   "executingUserKey":"Account Holder Verification",
   "live":false,
   "pspReference":"8815250896415072",
   "content":{
      "accountHolderCode":"TestAccountHolder",
      "verificationType":"IDENTITY_VERIFICATION",
      "verificationStatus":"INVALID_DATA",
      "statusSummary":{
         "description":"This user was not found in the database. Please update your personal details or upload a document",
         "code":1302
      }
   }
}

Code example: Pending review status

{
   "eventType":"ACCOUNT_HOLDER_VERIFICATION",
   "eventDate":"2018-04-30T14:13:01+02:00",
   "executingUserKey":"Account Holder Update",
   "live":false,
   "pspReference":"8515250903811555",
   "content":{
      "accountHolderCode":"TestAccountHolder",
      "verificationType":"IDENTITY_VERIFICATION",
      "verificationStatus":"PENDING"
   }
}

Code example: Retry limit reached

{
   "eventType":"ACCOUNT_HOLDER_VERIFICATION",
   "eventDate":"2018-04-30T14:07:20+02:00",
   "executingUserKey":"Account Holder Update",
   "live":false,
   "pspReference":"8815250900405267",
   "content":{
      "accountHolderCode":"TestAccountHolder",
      "verificationType":"IDENTITY_VERIFICATION",
      "verificationStatus":"RETRY_LIMIT_REACHED",
      "statusSummary":{
         "code":1606,
         "description":"The maximum amount of retries has been surpassed, please provide a document."
      }
   }
}