---
title: "Merchant account capability updated"
method: POST
path: "merchant.updated"
tags: ["Merchant account"]
---

# Merchant account capability updated

`POST merchant.updated` (webhook)

There were changes to the verification status and capabilities of a [merchant account](https://docs.adyen.com/api-explorer/#/ManagementService/latest/post/merchants). If the verification fails, this webhook includes the errors and the actions that you can take to resolve them.

## Payload

- MerchantUpdatedNotificationRequest
  - `createdAt` string, date-time, required — Timestamp for when the webhook was created.
  - `data` AccountUpdateNotificationData, required
    - `capabilities` object, required — Key-value pairs that specify what you can do with the merchant account and its settings. The key is a capability. For example, the **sendToTransferInstrument** is the capability required before you can pay out the funds of a merchant account to a [bank account](https://docs.adyen.com/api-explorer/legalentity/latest/post/transferInstruments). The value is an object containing the settings for the capability.
    - `legalEntityId` string — The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id).
    - `merchantId` string, required — The unique identifier of the merchant account.
    - `status` string, required — The status of the merchant account. Possible values: * **PreActive**: The merchant account has been created. Users cannot access the merchant account in the Customer Area. The account cannot process payments. * **Active**: Users can access the merchant account in the Customer Area. If the company account is also **Active**, then payment processing and payouts are enabled. * **InactiveWithModifications**: Users can access the merchant account in the Customer Area. The account cannot process new payments but can still modify payments, for example issue refunds. The account can still receive payouts. * **Inactive**: Users can access the merchant account in the Customer Area. Payment processing and payouts are disabled. * **Closed**: The account is closed and this cannot be reversed. Users cannot log in. Payment processing and payouts are disabled.
  - `environment` string, required — The environment from which the webhook originated. Possible values: **test**, **live**.
  - `type` 'merchant.updated', required — Type of notification.

## Acknowledgement `200`

OK - the request has succeeded.

- AccountNotificationResponse
  - `notificationResponse` string — Respond with any **2xx** HTTP status code to [accept the webhook](https://docs.adyen.com/development-resources/webhooks/#accept-webhooks).

---

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