---
title: "Incoming transfer updated"
method: POST
path: "balancePlatform.incomingTransfer.updated"
tags: ["Fund movements"]
deprecated: true
---

# Incoming transfer updated

`POST balancePlatform.incomingTransfer.updated` (webhook)

> **Deprecated.**

Adyen sends this webhook when funds were added to the balance account. This could be due to a refund or a funds transfer. Use the `data.id` to track the original incoming transfer resource in the `balancePlatform.incomingTransfer.created` webhook.

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

* For refunds, the `status` is **Refunded**. 

* For incoming fund transfers, the `status` is **IncomingTransfer**.

## Payload

- IncomingTransferNotificationRequest
  - `data` IncomingTransferNotificationData, required
    - `accountHolder` ResourceReference
      - `description` string — The description of the resource.
      - `id` string — The unique identifier of the resource.
      - `reference` string — The reference for the resource.
    - `amount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `balanceAccount` ResourceReference
      - `description` string — The description of the resource.
      - `id` string — The unique identifier of the resource.
      - `reference` string — The reference for the resource.
    - `balancePlatform` string — The unique identifier of the balance platform.
    - `counterparty` Counterparty
      - `balanceAccountId` string — The 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
        - `acquirerId` string — The unique identifier of the merchant's acquirer.
        - `mcc` string — The merchant category code.
        - `merchantId` string — The unique identifier of the merchant.
        - `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 postal code of the merchant.
      - `transferInstrumentId` string — The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/transferInstruments__resParam_id).
    - `creationDate` string, date-time — The date and time when the event was triggered, in ISO 8601 extended format. For example, **2025-03-19T10:15:30+01:00**.
    - `description` string — Your description for the transfer. If you send a description longer than 140 characters, the text is truncated.
    - `id` string — The ID of the resource.
    - `modification` NotificationModificationData
      - `amount` Amount
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
        - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
      - `type` string — The type of modification. Possible values: **Authorised**, **Cancelled**, **Captured**, **Error**, **Expired**, **OutgoingTransfer**, **PendingIncomingTransfer**, **PendingRefund**, **IncomingTransfer**, **Refunded**, **Refused**, **AuthAdjustmentAuthorised**.
    - `originalAmount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `paymentId` string — The ID of the original payment authorisation, refund, or funds transfer request. Use this to trace the original request from the `balancePlatform.payment.created` webhook.
    - `paymentInstrument` ResourceReference
      - `description` string — The description of the resource.
      - `id` string — The unique identifier of the resource.
      - `reference` string — The reference for the resource.
    - `platformPayment` PlatformPayment
      - `account` string — The account given in the related split.
      - `description` string — The description of the related split.
      - `modificationMerchantReference` string — The merchant reference of the modification.
      - `modificationPspReference` string — The pspReference of the modification.
      - `paymentMerchantReference` string — The merchant reference of the payment.
      - `paymentPspReference` string — The pspReference of the payment.
      - `reference` string — The reference of the related split.
      - `type` 'AcquiringFees' | 'AdyenCommission' | 'AdyenFees' | 'AdyenMarkup' | 'BalanceAccount' | 'ChargebackRemainder' | 'Commission' | 'DCCMarkup' | 'DCCPlatformCommission' | 'Default' | 'Interchange' | 'PaymentFee' | 'Remainder' | 'SchemeFee' | 'Surcharge' | 'Tip' | 'TopUp' | 'VAT' — The type of the related split.
    - `reference` string — An Adyen-generated unique reference for the transfer.
    - `referenceForBeneficiary` string — The reference sent to or received from the counterparty. * For outgoing funds, this is the [`referenceForBeneficiary`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__resParam_referenceForBeneficiary) from the [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers) request. * For incoming funds, this is the reference from the sender.
    - `status` string — The event status. The possible values depend on the `type`. * **Authorised**, **Refused**, or **Error** for type `balancePlatform.payment.created` * **Expired** or **Cancelled** or **AuthAdjustmentAuthorised** or **AuthAdjustmentRefused** for type `balancePlatform.payment.updated` * **PendingIncomingTransfer** for type `balancePlatform.incomingTransfer.created` * **Refunded** or **IncomingTransfer** for type `balancePlatform.incomingTransfer.updated` * **Captured** or **OutgoingTransfer** for type `balancePlatform.outgoingTransfer.created` * **TransferConfirmed**, **TransferSentOut**, or **TransferFailed** for type `balancePlatform.outgoingTransfer.updated`
    - `threeDSecure` ThreeDSecure
      - `acsTransactionId` string — The transaction identifier for the Access Control Server
      - `authenticationResult` string — The result from the performed authentication
      - `authenticationType` string — The type of the performed authentication
      - `dsTransactionId` string — The transaction identifier for the Directory server
    - `valueDate` string, date-time — Indicates the expected settlement date of this transaction, in ISO 8601 extended format. For example, **2021-08-17T15:34:37+02:00**.
  - `environment` string, required — The environment from which the webhook originated. Possible values: **test**, **live**.
  - `timestamp` string, date-time — When the event was queued.
  - `type` 'balancePlatform.incomingTransfer.updated' | 'balancePlatform.incomingTransfer.created', required — Type of webhook.

## Acknowledgement `200`

OK - the request has succeeded.

- BalancePlatformNotificationResponse
  - `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/payment-webhooks-deprecated.md) · [All operations](https://skmtc.dev/adyen/apis/payment-webhooks-deprecated/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/payment-webhooks-deprecated/revisions/f977bd66d03e/schema)