ACCOUNT_HOLDER_STATUS_CHANGE

This notification is triggered when the status of an account holder is changed (for example, when the processing amount exceeds the current tier's limits and proceeds to the next tier).

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

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.

newStatus
AccountHolderStatus (tick)

New status of the account holder.

oldStatus
AccountHolderStatus   (tick)

Old status of the account holder.

reason
String (error)

Reason for status change.

 

Code example: Status change message triggered on removal of account holder details

{
   "eventType":"ACCOUNT_HOLDER_STATUS_CHANGE",
   "eventDate":"2018-04-23T13:13:44+02:00",
   "executingUserKey":"ws",
   "live":true,
   "pspReference":"Test_ACCOUNT_HOLDER_STATUS_CHANGE",
   "content":{
      "accountHolderCode":"TestAccountHolder",
      "newStatus":{
         "status":"Active",
         "processingState":{
            "processedFrom":{
               "currency":"GBP",
               "value":0
            },
            "processedTo":{
               "currency":"GBP",
               "value":9999
            }
         },
         "payoutState":{
            "allowPayout":"true",
            "payoutLimit":{
               "currency":"GBP",
               "value":49999
            }
         }
      },
      "oldStatus":{
         "status":"Inactive",
         "processingState":{
            "processedFrom":{
               "currency":"GBP",
               "value":0
            },
            "processedTo":{
               "currency":"GBP",
               "value":9999
            }
         },
         "payoutState":{
            "allowPayout":"true",
            "payoutLimit":{
               "currency":"GBP",
               "value":49999
            }
         }
      },
      "reason":"Test Reason"
   }
}