---
title: "Triggered upon the status change of an account holder."
method: POST
path: "/ACCOUNT_HOLDER_STATUS_CHANGE"
---

# Triggered upon the status change of an account holder.

`POST /ACCOUNT_HOLDER_STATUS_CHANGE`

This notification is sent when the status of an account holder has been changed.

## Request body

- AccountHolderStatusChangeNotification
  - `content` AccountHolderStatusChangeNotificationContent
    - `accountHolderCode` string, required — The code of the account holder.
    - `newStatus` AccountHolderStatus, required
      - `events` AccountEvent[] — A list of events scheduled for the account holder.
        - `event` 'InactivateAccount' | 'RefundNotPaidOutTransfers', required — The event. >Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`. For more information, refer to [Verification checks](https://docs.adyen.com/platforms/verification-checks).
        - `executionDate` string, date-time, required — The date on which the event will take place.
        - `reason` string, required — 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, required
      - `events` AccountEvent[] — A list of events scheduled for the account holder.
        - `event` 'InactivateAccount' | 'RefundNotPaidOutTransfers', required — The event. >Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`. For more information, refer to [Verification checks](https://docs.adyen.com/platforms/verification-checks).
        - `executionDate` string, date-time, required — The date on which the event will take place.
        - `reason` string, required — 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.

## Response `200`

OK - the request has succeeded.

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

## Changes

- **2021-03-22** (v3) `1ee4204802ea` — 2 breaking
  - added the new required request property `content/newStatus`
  - added the new required request property `content/oldStatus`
- **2021-03-05** (v3) `f1e00a7d736c` — 2 warning
  - removed the request property `content/newStatus`
  - removed the request property `content/oldStatus`
- **2020-08-05** (v3) `d32ba44e5a85` — 1 breaking, 30 info
  - the response property `notificationResponse` became optional for the status `200`
  - api operation id `post-ACCOUNT_HOLDER_STATUS_CHANGE` was added
  - the request property `content/newStatus/events` became optional
  - the request property `content/newStatus/payoutState` became optional
  - …27 more
- **2020-03-04** (v3) `0c0608483efe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/marketpaynotificationservice/changes/ACCOUNT_HOLDER_STATUS_CHANGE/post.md)

---

[API](https://skmtc.dev/adyen/apis/marketpaynotificationservice.md) · [All operations](https://skmtc.dev/adyen/apis/marketpaynotificationservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/marketpaynotificationservice/revisions/6cbb7c4c1415?raw)