---
title: "Transfer updated"
method: POST
path: "balancePlatform.transfer.updated"
tags: ["General"]
---

# Transfer updated

`POST balancePlatform.transfer.updated` (webhook)

Adyen sends this webhook when the status of a transfer changes. Use the `data.id` to track the original transfer resource in the [balancePlatform.transfer.created](https://docs.adyen.com/api-explorer/accounting-webhooks/1/post/balancePlatform.transfer.created) webhook.

The `status` field indicates the event that triggered the webhook.

## Payload

- TransferNotificationRequest
  - `data` Transfer, required
    - `amount` Amount, required
      - `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).
    - `balanceAccountId` string — Unique identifier of the source [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `bank` Bank
      - `priority` 'fast' | 'instant' | 'regular' | 'wire' — The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. If you don't provide this in the request, Adyen sets the optimal priority. Possible values: * **regular**: For normal, low-value transactions. * **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions. * **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions. * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).
    - `counterparty` Counterparty, required
      - `balanceAccountId` string — Unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
      - `bankAccount` BankAccountInfo
        - `address` Address
          - `city` string, required — The name of the city. Maximum length: 3000 characters.
          - `country` string, required — The two-character ISO-3166-1 alpha-2 country code. For example, **US**. > If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`.
          - `houseNumberOrName` string, required — The number or name of the house. Maximum length: 3000 characters.
          - `postalCode` string, required — A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries.
          - `stateOrProvince` string — The two-character ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
          - `street` string, required — The name of the street. Maximum length: 3000 characters. > The house number should not be included in this field; it should be separately provided via `houseNumberOrName`.
        - `iban` string — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
        - `ownerName` Name
          - `firstName` string — The first name.
          - `fullName` string — The full name.
          - `infix` string — The infix in the name, if any.
          - `lastName` string — The last name.
      - `merchant` MerchantData
        - `mcc` string — The merchant category code.
        - `merchantId` string — The merchant identifier.
        - `nameLocation` NameLocation
          - `city` string — The city where the merchant is located.
          - `country` string — The country where the merchant is located in [three-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format.
          - `countryOfOrigin` string — The home country in [three-digit country code](https://en.wikipedia.org/wiki/ISO_3166-1_numeric) format, used for government-controlled merchants such as embassies.
          - `name` string — The name of the merchant's shop or service.
          - `rawData` string — The raw data.
          - `state` string — The state where the merchant is located.
        - `postalCode` string — The merchant postal code.
      - `transferInstrumentId` string — Unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/transferInstruments__resParam_id).
    - `description` string — A human-readable description for the transfer. You can use alphanumeric characters and hyphens. We recommend sending a maximum of 140 characters, otherwise the description may be truncated.
    - `id` string — The ID of the resource.
    - `paymentInstrumentId` string — Unique identifier of the source [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).
  - `environment` string, required — The environment from which the webhook originated. Possible values: **test**, **live**.
  - `type` 'balancePlatform.transfer.created' | 'balancePlatform.transfer.updated' — The type of the notification.

## Acknowledgement `200`

OK - the request has succeeded.

- BalancePlatformNotificationResponse
  - `notificationResponse` string — Respond with **HTTP 200 OK** and `[accepted]` in the response body to [accept the webhook](https://docs.adyen.com/development-resources/webhooks#accept-notifications).

---

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