---
title: "Account holder status changed"
method: POST
path: "/ACCOUNT_HOLDER_STATUS_CHANGE"
tags: ["Account holders"]
---

# Account holder status changed

`POST /ACCOUNT_HOLDER_STATUS_CHANGE` (webhook)

Adyen sends this webhook when [the status of an account holder is changed](https://docs.adyen.com/api-explorer/#/Account/latest/post/updateAccountHolderState).

## Payload

- AccountHolderStatusChangeNotification
  - `content` AccountHolderStatusChangeNotificationContent
    - `accountHolderCode` string, required — The code of the account holder.
    - `newStatus` AccountHolderStatus
      - `events` AccountEventWrapper[] — A list of events scheduled for the account holder.
        - `AccountEvent` AccountEvent
          - `event` 'InactivateAccount' | 'RefundNotPaidOutTransfers' — The event. >Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`. For more information, refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-process).
          - `executionDate` string, date-time — The date on which the event will take place.
          - `reason` string — The reason why this event has been created.
      - `payoutState` AccountPayoutState
        - `allowPayout` boolean — Indicates whether payouts are allowed. This field is the overarching payout status, and is the aggregate of multiple conditions (e.g., KYC status, disabled flag, etc). If this field is false, no payouts will be permitted for any of the account holder's accounts. If this field is true, payouts will be permitted for any of the account holder's accounts.
        - `disableReason` string — The reason why payouts (to all of the account holder's accounts) have been disabled (by the platform). If the `disabled` field is true, this field can be used to explain why.
        - `disabled` boolean — Indicates whether payouts have been disabled (by the platform) for all of the account holder's accounts. A platform may enable and disable this field at their discretion. If this field is true, `allowPayout` will be false and no payouts will be permitted for any of the account holder's accounts. If this field is false, `allowPayout` may or may not be enabled, depending on other factors.
        - `payoutLimit` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `tierNumber` integer — The payout tier that the account holder occupies.
      - `processingState` AccountProcessingState
        - `disableReason` string — The reason why processing has been disabled.
        - `disabled` boolean — Indicates whether the processing of payments is allowed.
        - `processedFrom` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `processedTo` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `tierNumber` integer — The processing tier that the account holder occupies.
      - `status` 'Active' | 'Closed' | 'Inactive' | 'Suspended', required — The status of the account holder. >Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.
      - `statusReason` string — The reason why the status was assigned to the account holder.
    - `oldStatus` AccountHolderStatus
      - `events` AccountEventWrapper[] — A list of events scheduled for the account holder.
        - `AccountEvent` AccountEvent
          - `event` 'InactivateAccount' | 'RefundNotPaidOutTransfers' — The event. >Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`. For more information, refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-process).
          - `executionDate` string, date-time — The date on which the event will take place.
          - `reason` string — The reason why this event has been created.
      - `payoutState` AccountPayoutState
        - `allowPayout` boolean — Indicates whether payouts are allowed. This field is the overarching payout status, and is the aggregate of multiple conditions (e.g., KYC status, disabled flag, etc). If this field is false, no payouts will be permitted for any of the account holder's accounts. If this field is true, payouts will be permitted for any of the account holder's accounts.
        - `disableReason` string — The reason why payouts (to all of the account holder's accounts) have been disabled (by the platform). If the `disabled` field is true, this field can be used to explain why.
        - `disabled` boolean — Indicates whether payouts have been disabled (by the platform) for all of the account holder's accounts. A platform may enable and disable this field at their discretion. If this field is true, `allowPayout` will be false and no payouts will be permitted for any of the account holder's accounts. If this field is false, `allowPayout` may or may not be enabled, depending on other factors.
        - `payoutLimit` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `tierNumber` integer — The payout tier that the account holder occupies.
      - `processingState` AccountProcessingState
        - `disableReason` string — The reason why processing has been disabled.
        - `disabled` boolean — Indicates whether the processing of payments is allowed.
        - `processedFrom` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `processedTo` Amount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `tierNumber` integer — The processing tier that the account holder occupies.
      - `status` 'Active' | 'Closed' | 'Inactive' | 'Suspended', required — The status of the account holder. >Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.
      - `statusReason` string — The reason why the status was assigned to the account holder.
    - `reason` string — The reason for the status change.
  - `eventType` string, required — The event type of the notification.
  - `executingUserKey` string, required — The user or process that has triggered the notification.
  - `live` boolean, required — Indicates whether the notification originated from the live environment or the test environment. If true, the notification originated from the live environment. If false, the notification originated from the test environment.
  - `pspReference` string, required — The PSP reference of the request from which the notification originates.

## Acknowledgement `200`

OK - the request has succeeded.

- NotificationResponse
  - `notificationResponse` string — Set this parameter to **[accepted]** to acknowledge that you received a notification from Adyen.

---

[API](https://skmtc.net/adyen/apis/marketpaynotificationservice.md) · [All operations](https://skmtc.net/adyen/apis/marketpaynotificationservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/marketpaynotificationservice/versions/fae4b3da8f9f/schema)