ACCOUNT_HOLDER_UPDATED

This notification is triggered when an account holder is updated.

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_UPDATED.

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
pspReference String (tick) PSP Reference of the call to /updateAccountHolder the account holder.
accountHolderCode String (tick)

A code identifying the account holder.

accountHolderDetails AccountHolderDetails (tick)

Details of the updated account holder.

accountHolderStatus AccountHolderStatus (tick)

Status of the updated account holder.

invalidFields Array (error)

In case the account holder has not been updated, contains account holder fields that did not pass the validation.

This array contains the ErrorFieldType elements.

updatedFields Array (error)

Contains account holder fields that have been updated.

This array contains the ErrorFieldType elements.

verification Verification (tick)

KYC verification results. For more information, refer to KYC verification checks.

Code example: Updating Individual/business account holder details

{
   "eventType":"ACCOUNT_HOLDER_UPDATED",
   "eventDate":"2018-04-23T13:13:44+02:00",
   "executingUserKey":"ws",
   "live":false,
   "pspReference":"9914806717720145",
   "content":{
      "pspReference":"9914806717720145",
      "accountHolderCode":"TestAccountHolder639244",
      "accountHolderDetails":{
         "address":{
            "city":"Amsterdam",
            "country":"US",
            "postalCode":"12345",
            "stateOrProvince":"NH",
            "street":"Teststreet 1"
         },
         "bankAccountDetails":[

         ],
         "email":"test@adyen.com",
         "individualDetails":{
            "name":{
               "firstName":"First name",
               "gender":"MALE",
               "lastName":"Last Name"
            },
            "personalData":{
               "dateOfBirth":"1970-01-01",
               "idNumber":"1234567890",
               "nationality":"NL"
            }
         },
         "merchantCategoryCode":"7999",
         "phoneNumber":{
            "phoneCountryCode":"NL",
            "phoneNumber":"0612345678",
            "phoneType":"Mobile"
         },
         "webAddress":"http://www.adyen.com"
      },
      "accountHolderStatus":{
         "status":"Active",
         "processingState":{
            "processedFrom":{
               "currency":"GBP",
               "value":0
            },
            "processedTo":{
               "currency":"GBP",
               "value":9999
            }
         },
         "payoutState":{
            "allowPayout":"true",
            "payoutLimit":{
               "currency":"GBP",
               "value":49999
            }
         }
      },
      "invalidFields":[

      ],
      "verification":{
         "accountHolder":{
            "checks":[
               {
                  "type":"PASSPORT_VERIFICATION",
                  "status":"AWAITING_DATA",
                  "requiredFields":[
                     "AccountHolderDetails.Document.passport"
                  ]
               },
               {
                  "type":"IDENTITY_VERIFICATION",
                  "status":"PASSED",
                  "summary":{
                     "code":1602,
                     "description":"Passed"
                  }
               }
            ]
         },
         "updatedFields":[

         ]
      }
   }
}