---
title: "Update payout or processing state"
method: POST
path: "/updateAccountHolderState"
tags: ["Account holders"]
---

# Update payout or processing state

`POST /updateAccountHolderState`

Disables or enables the processing or payout state of an account holder.

## Request body

- UpdateAccountHolderStateRequest
  - `accountHolderCode` string, required — The code of the Account Holder on which to update the state.
  - `disable` boolean, required — If true, disable the requested state. If false, enable the requested state.
  - `reason` string — The reason that the state is being updated. >Required if the state is being disabled.
  - `stateType` 'LimitedPayout' | 'LimitedProcessing' | 'LimitlessPayout' | 'LimitlessProcessing' | 'Payout' | 'Processing', required — The state to be updated. >Permitted values are: `Processing`, `Payout`

## Response `200`

OK - the request has succeeded.

- GetAccountHolderStatusResponse
  - `accountHolderCode` string — The code of the Account Holder.
  - `accountHolderStatus` 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.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

> 28 revisions in range; 1 could not be searched.

- **2023-04-12** (v3) `9371f31bd06c` — 2 breaking, 6 warning, 2 info
  - the `accountHolderStatus/events/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `accountHolderStatus/events/items/` response's property type/format changed from `object`/`` to ``/`` for status `202`
  - removed the optional property `accountHolderStatus/events/items/event` from the response with the `200` status
  - removed the optional property `accountHolderStatus/events/items/event` from the response with the `202` status
  - …6 more
- **2023-03-22** (v3) `a6068822877c` — 32 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `202`
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - …28 more
- **2021-08-07** (v3) `9ca745af6f06` — 1 info
  - api tag `Account holders` added
- **2021-07-09** (v3) `178852251c31` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
- …earlier changes not shown

[Full history](https://skmtc.dev/adyen/apis/accountservice/changes/updateAccountHolderState/post.md)

---

[API](https://skmtc.dev/adyen/apis/accountservice.md) · [All operations](https://skmtc.dev/adyen/apis/accountservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/accountservice/revisions/5896dea74c98/schema)