---
title: "Transfer funds"
method: POST
path: "/transfers"
tags: ["Transfers"]
---

# Transfer funds

`POST /transfers`

>Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.

Starts a request to transfer funds to [balance accounts](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts), [transfer instruments](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments), or third-party bank accounts. Adyen sends the outcome of the transfer request through webhooks.

To use this endpoint, you need an additional role for your API credential and transfers must be enabled for the source balance account. Your Adyen contact will set these up for you.

## Headers

- `WWW-Authenticate` string

## Request body

- TransferInfo
  - `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 — The unique identifier of the source [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
  - `category` 'bank' | 'internal' | 'issuedCard' | 'platformPayment' | 'card', required — The type of transfer. Possible values: - **bank**: Transfer to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id) or a bank account. - **internal**: Transfer to another [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id) within your platform. - **issuedCard**: Transfer initiated by a Adyen-issued card. - **platformPayment**: Fund movements related to payments that are acquired for your users.
  - `counterparty` CounterpartyInfoV3, required
    - `balanceAccountId` string — Unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `bankAccount` BankAccountV3
      - `accountHolder` PartyIdentification, required
        - `address` Address
          - `city` string — The name of the city.
          - `country` string, required — The two-character ISO 3166-1 alpha-2 country code. For example, **US**, **NL**, or **GB**.
          - `line1` string — First line of the street address.
          - `line2` string — Second line of the street address.
          - `postalCode` string — The postal code. Maximum length: * 5 digits for an address in the US. * 10 characters for an address in all other countries.
          - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
        - `dateOfBirth` string, date — The date of birth of the individual in [ISO-8601](https://www.w3.org/TR/NOTE-datetime) format. For example, **YYYY-MM-DD**. Should not be before January 1, 1900. Allowed only when `type` is **individual**.
        - `firstName` string — First name of the individual. Allowed only when `type` is **individual**.
        - `fullName` string, required — The name of the entity.
        - `lastName` string — Last name of the individual. Allowed only when `type` is **individual**.
        - `reference` string — A unique reference to identify the party or counterparty involved in transfers. This identifier ensures consistency and uniqueness throughout all transactions initiated to and from the same party. For example, your client's unique wallet or payee ID.
        - `type` 'individual' | 'organization' | 'unknown' — The type of entity that owns the bank account. Possible values: **individual**, **organization**, or **unknown**.
      - `accountIdentification` union, required — Contains the bank account details. The fields required in this object depend on the country of the bank account and the currency of the transfer.
        - AULocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `bsbCode` string, required — The 6-digit [Bank State Branch (BSB) code](https://en.wikipedia.org/wiki/Bank_state_branch), without separators or whitespace.
          - `type` 'auLocal', required — **auLocal**
        - BRLocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `bankCode` string, required — The 3-digit bank code, with leading zeros.
          - `branchNumber` string, required — The bank account branch number, without separators or whitespace.
          - `type` 'brLocal', required — **brLocal**
        - CALocalAccountIdentification
          - `accountNumber` string, required — The 5- to 12-digit bank account number, without separators or whitespace.
          - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**.
          - `institutionNumber` string, required — The 3-digit institution number, without separators or whitespace.
          - `transitNumber` string, required — The 5-digit transit number, without separators or whitespace.
          - `type` 'caLocal', required — **caLocal**
        - CZLocalAccountIdentification
          - `accountNumber` string, required — The 2- to 16-digit bank account number (Číslo účtu) in the following format: - The optional prefix (předčíslí). - The required second part (základní část) which must be at least two non-zero digits. Examples: - **19-123457** (with prefix) - **123457** (without prefix) - **000019-0000123457** (with prefix, normalized) - **000000-0000123457** (without prefix, normalized)
          - `bankCode` string, required — The 4-digit bank code (Kód banky), without separators or whitespace.
          - `type` 'czLocal', required — **czLocal**
        - DKLocalAccountIdentification
          - `accountNumber` string, required — The 4-10 digits bank account number (Kontonummer) (without separators or whitespace).
          - `bankCode` string, required — The 4-digit bank code (Registreringsnummer) (without separators or whitespace).
          - `type` 'dkLocal', required — **dkLocal**
        - HKLocalAccountIdentification
          - `accountNumber` string, required — The 9- to 15-character bank account number (alphanumeric), without separators or whitespace. Starts with the 3-digit branch code.
          - `clearingCode` string, required — The 3-digit clearing code, without separators or whitespace.
          - `type` 'hkLocal', required — **hkLocal**
        - HULocalAccountIdentification
          - `accountNumber` string, required — The 24-digit bank account number, without separators or whitespace.
          - `type` 'huLocal', required — **huLocal**
        - IbanAccountIdentification
          - `iban` string, required — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
          - `type` 'iban', required — **iban**
        - NOLocalAccountIdentification
          - `accountNumber` string, required — The 11-digit bank account number, without separators or whitespace.
          - `type` 'noLocal', required — **noLocal**
        - NZLocalAccountIdentification
          - `accountNumber` string, required — The 15-16 digit bank account number. The first 2 digits are the bank number, the next 4 digits are the branch number, the next 7 digits are the account number, and the final 2-3 digits are the suffix.
          - `type` 'nzLocal', required — **nzLocal**
        - NumberAndBicAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace. The length and format depends on the bank or country.
          - `additionalBankIdentification` AdditionalBankIdentification
            - `code` string — The value of the additional bank identification.
            - `type` 'gbSortCode' | 'usRoutingNumber' — The type of additional bank identification, depending on the country. Possible values: * **gbSortCode**: The 6-digit [UK sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or spaces * **usRoutingNumber**: The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or spaces.
          - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code.
          - `type` 'numberAndBic', required — **numberAndBic**
        - PLLocalAccountIdentification
          - `accountNumber` string, required — The 26-digit bank account number ([Numer rachunku](https://pl.wikipedia.org/wiki/Numer_Rachunku_Bankowego)), without separators or whitespace.
          - `type` 'plLocal', required — **plLocal**
        - SELocalAccountIdentification
          - `accountNumber` string, required — The 7- to 10-digit bank account number ([Bankkontonummer](https://sv.wikipedia.org/wiki/Bankkonto)), without the clearing number, separators, or whitespace.
          - `clearingNumber` string, required — The 4- to 5-digit clearing number ([Clearingnummer](https://sv.wikipedia.org/wiki/Clearingnummer)), without separators or whitespace.
          - `type` 'seLocal', required — **seLocal**
        - SGLocalAccountIdentification
          - `accountNumber` string, required — The 4- to 19-digit bank account number, without separators or whitespace.
          - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code.
          - `type` 'sgLocal' — **sgLocal**
        - UKLocalAccountIdentification
          - `accountNumber` string, required — The 8-digit bank account number, without separators or whitespace.
          - `sortCode` string, required — The 6-digit [sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or whitespace.
          - `type` 'ukLocal', required — **ukLocal**
        - USLocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**.
          - `routingNumber` string, required — The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or whitespace.
          - `type` 'usLocal', required — **usLocal**
    - `transferInstrumentId` string — Unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).
  - `description` string — Your description for the transfer. It is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated. Supported characters: **[a-z] [A-Z] [0-9] / - ?** **: ( ) . , ' + Space** Supported characters for **regular** and **fast** transfers to a US counterparty: **[a-z] [A-Z] [0-9] & $ % # @** **~ = + - _ ' " ! ?**
  - `paymentInstrumentId` string — The unique identifier of the source [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).
  - `priority` 'crossBorder' | 'fast' | 'instant' | 'internal' | '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. Required for transfers with `category` **bank**. 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). * **crossBorder**: High-value transfer to a recipient in a different country. * **internal**: Transfer to an Adyen-issued business bank account (by bank account number/IBAN).
  - `reference` string — Your reference for the transfer, used internally within your platform. If you don't provide this in the request, Adyen generates a unique reference.
  - `referenceForBeneficiary` string — A reference that is sent to the recipient. This reference is also sent in all webhooks related to the transfer, so you can use it to track statuses for both the source and recipient of funds. Supported characters: **a-z**, **A-Z**, **0-9**. The maximum length depends on the `category`. - **internal**: 80 characters - **bank**: 35 characters when transferring to an IBAN, 15 characters for others.
  - `ultimateParty` UltimatePartyIdentification
    - `address` Address
      - `city` string — The name of the city.
      - `country` string, required — The two-character ISO 3166-1 alpha-2 country code. For example, **US**, **NL**, or **GB**.
      - `line1` string — First line of the street address.
      - `line2` string — Second line of the street address.
      - `postalCode` string — The postal code. Maximum length: * 5 digits for an address in the US. * 10 characters for an address in all other countries.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
    - `dateOfBirth` string, date — The date of birth of the individual in [ISO-8601](https://www.w3.org/TR/NOTE-datetime) format. For example, **YYYY-MM-DD**. Should not be before January 1, 1900. Allowed only when `type` is **individual**.
    - `firstName` string — First name of the individual. Allowed only when `type` is **individual**.
    - `fullName` string, required — The name of the entity.
    - `lastName` string — Last name of the individual. Allowed only when `type` is **individual**.
    - `reference` string — A unique reference to identify the party or counterparty involved in transfers. This identifier ensures consistency and uniqueness throughout all transactions initiated to and from the same party. For example, your client's unique wallet or payee ID.
    - `type` 'individual' | 'organization' | 'unknown' — The type of entity that owns the bank account. Possible values: **individual**, **organization**, or **unknown**.

## Response `200`

OK - the request has succeeded.

- Transfer
  - `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, 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).
  - `balanceAccount` ResourceReference
    - `description` string — The description of the resource.
    - `id` string — The unique identifier of the resource.
    - `reference` string — The reference for the resource.
  - `balanceAccountId` string — The unique identifier of the source [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
  - `category` 'bank' | 'internal' | 'issuedCard' | 'platformPayment', required — The category of transfer. Possible values: - **bank**: Transfer to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id) or a bank account. - **internal**: Transfer to another [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id) within your platform. - **issuedCard**: Transfer initiated by a Adyen-issued card. - **platformPayment**: Fund movements related to payments that are acquired for your users.
  - `counterparty` CounterpartyV3, required
    - `balanceAccountId` string — Unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `bankAccount` BankAccountV3
      - `accountHolder` PartyIdentification, required
        - `address` Address
          - `city` string — The name of the city.
          - `country` string, required — The two-character ISO 3166-1 alpha-2 country code. For example, **US**, **NL**, or **GB**.
          - `line1` string — First line of the street address.
          - `line2` string — Second line of the street address.
          - `postalCode` string — The postal code. Maximum length: * 5 digits for an address in the US. * 10 characters for an address in all other countries.
          - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
        - `dateOfBirth` string, date — The date of birth of the individual in [ISO-8601](https://www.w3.org/TR/NOTE-datetime) format. For example, **YYYY-MM-DD**. Should not be before January 1, 1900. Allowed only when `type` is **individual**.
        - `firstName` string — First name of the individual. Allowed only when `type` is **individual**.
        - `fullName` string, required — The name of the entity.
        - `lastName` string — Last name of the individual. Allowed only when `type` is **individual**.
        - `reference` string — A unique reference to identify the party or counterparty involved in transfers. This identifier ensures consistency and uniqueness throughout all transactions initiated to and from the same party. For example, your client's unique wallet or payee ID.
        - `type` 'individual' | 'organization' | 'unknown' — The type of entity that owns the bank account. Possible values: **individual**, **organization**, or **unknown**.
      - `accountIdentification` union, required — Contains the bank account details. The fields required in this object depend on the country of the bank account and the currency of the transfer.
        - AULocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `bsbCode` string, required — The 6-digit [Bank State Branch (BSB) code](https://en.wikipedia.org/wiki/Bank_state_branch), without separators or whitespace.
          - `type` 'auLocal', required — **auLocal**
        - BRLocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `bankCode` string, required — The 3-digit bank code, with leading zeros.
          - `branchNumber` string, required — The bank account branch number, without separators or whitespace.
          - `type` 'brLocal', required — **brLocal**
        - CALocalAccountIdentification
          - `accountNumber` string, required — The 5- to 12-digit bank account number, without separators or whitespace.
          - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**.
          - `institutionNumber` string, required — The 3-digit institution number, without separators or whitespace.
          - `transitNumber` string, required — The 5-digit transit number, without separators or whitespace.
          - `type` 'caLocal', required — **caLocal**
        - CZLocalAccountIdentification
          - `accountNumber` string, required — The 2- to 16-digit bank account number (Číslo účtu) in the following format: - The optional prefix (předčíslí). - The required second part (základní část) which must be at least two non-zero digits. Examples: - **19-123457** (with prefix) - **123457** (without prefix) - **000019-0000123457** (with prefix, normalized) - **000000-0000123457** (without prefix, normalized)
          - `bankCode` string, required — The 4-digit bank code (Kód banky), without separators or whitespace.
          - `type` 'czLocal', required — **czLocal**
        - DKLocalAccountIdentification
          - `accountNumber` string, required — The 4-10 digits bank account number (Kontonummer) (without separators or whitespace).
          - `bankCode` string, required — The 4-digit bank code (Registreringsnummer) (without separators or whitespace).
          - `type` 'dkLocal', required — **dkLocal**
        - HKLocalAccountIdentification
          - `accountNumber` string, required — The 9- to 15-character bank account number (alphanumeric), without separators or whitespace. Starts with the 3-digit branch code.
          - `clearingCode` string, required — The 3-digit clearing code, without separators or whitespace.
          - `type` 'hkLocal', required — **hkLocal**
        - HULocalAccountIdentification
          - `accountNumber` string, required — The 24-digit bank account number, without separators or whitespace.
          - `type` 'huLocal', required — **huLocal**
        - IbanAccountIdentification
          - `iban` string, required — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
          - `type` 'iban', required — **iban**
        - NOLocalAccountIdentification
          - `accountNumber` string, required — The 11-digit bank account number, without separators or whitespace.
          - `type` 'noLocal', required — **noLocal**
        - NZLocalAccountIdentification
          - `accountNumber` string, required — The 15-16 digit bank account number. The first 2 digits are the bank number, the next 4 digits are the branch number, the next 7 digits are the account number, and the final 2-3 digits are the suffix.
          - `type` 'nzLocal', required — **nzLocal**
        - NumberAndBicAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace. The length and format depends on the bank or country.
          - `additionalBankIdentification` AdditionalBankIdentification
            - `code` string — The value of the additional bank identification.
            - `type` 'gbSortCode' | 'usRoutingNumber' — The type of additional bank identification, depending on the country. Possible values: * **gbSortCode**: The 6-digit [UK sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or spaces * **usRoutingNumber**: The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or spaces.
          - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code.
          - `type` 'numberAndBic', required — **numberAndBic**
        - PLLocalAccountIdentification
          - `accountNumber` string, required — The 26-digit bank account number ([Numer rachunku](https://pl.wikipedia.org/wiki/Numer_Rachunku_Bankowego)), without separators or whitespace.
          - `type` 'plLocal', required — **plLocal**
        - SELocalAccountIdentification
          - `accountNumber` string, required — The 7- to 10-digit bank account number ([Bankkontonummer](https://sv.wikipedia.org/wiki/Bankkonto)), without the clearing number, separators, or whitespace.
          - `clearingNumber` string, required — The 4- to 5-digit clearing number ([Clearingnummer](https://sv.wikipedia.org/wiki/Clearingnummer)), without separators or whitespace.
          - `type` 'seLocal', required — **seLocal**
        - SGLocalAccountIdentification
          - `accountNumber` string, required — The 4- to 19-digit bank account number, without separators or whitespace.
          - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code.
          - `type` 'sgLocal' — **sgLocal**
        - UKLocalAccountIdentification
          - `accountNumber` string, required — The 8-digit bank account number, without separators or whitespace.
          - `sortCode` string, required — The 6-digit [sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or whitespace.
          - `type` 'ukLocal', required — **ukLocal**
        - USLocalAccountIdentification
          - `accountNumber` string, required — The bank account number, without separators or whitespace.
          - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**.
          - `routingNumber` string, required — The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or whitespace.
          - `type` 'usLocal', required — **usLocal**
    - `merchant` MerchantData
      - `acquirerId` string — The unique identifier of the merchant's acquirer.
      - `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/#/legalentity/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, **2020-12-18T10:15:30+01:00**.
  - `description` string — Your description for the transfer. It is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated. Supported characters: **[a-z] [A-Z] [0-9] / - ?** **: ( ) . , ' + Space** Supported characters for **regular** and **fast** transfers to a US counterparty: **[a-z] [A-Z] [0-9] & $ % # @** **~ = + - _ ' " ! ?**
  - `direction` 'incoming' | 'outgoing' — The direction of the transfer. Possible values: **incoming**, **outgoing**.
  - `id` string — The ID of the resource.
  - `paymentInstrument` PaymentInstrument
    - `description` string — The description of the resource.
    - `id` string — The unique identifier of the resource.
    - `reference` string — The reference for the resource.
    - `tokenType` string — The type of wallet the network token is associated with.
  - `paymentInstrumentId` string — The unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id) used in the transfer.
  - `priority` 'crossBorder' | 'fast' | 'instant' | 'internal' | '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. Required for transfers with `category` **bank**. 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). * **crossBorder**: High-value transfer to a recipient in a different country. * **internal**: Transfer to an Adyen-issued business bank account (by bank account number/IBAN). This will be removed in v4 and replaced with a new field.
  - `reason` 'amountLimitExceeded' | 'approved' | 'balanceAccountTemporarilyBlockedByTransactionRule' | 'counterpartyAccountBlocked' | 'counterpartyAccountClosed' | 'counterpartyAccountNotFound' | 'counterpartyAddressRequired' | 'counterpartyBankTimedOut' | 'counterpartyBankUnavailable' | 'declinedByTransactionRule' | 'error' | 'notEnoughBalance' | 'refusedByCounterpartyBank' | 'routeNotFound' | 'scaFailed' | 'unknown' — Additional information about the status of the transfer.
  - `reference` string — Your reference for the transfer, used internally within your platform. If you don't provide this in the request, Adyen generates a unique reference.
  - `referenceForBeneficiary` string — A reference that is sent to the recipient. This reference is also sent in all webhooks related to the transfer, so you can use it to track statuses for both the source and recipient of funds. Supported characters: **a-z**, **A-Z**, **0-9**. The maximum length depends on the `category`. - **internal**: 80 characters - **bank**: 35 characters when transferring to an IBAN, 15 characters for others.
  - `status` 'approvalPending' | 'atmWithdrawal' | 'atmWithdrawalReversalPending' | 'atmWithdrawalReversed' | 'authAdjustmentAuthorised' | 'authAdjustmentError' | 'authAdjustmentRefused' | 'authorised' | 'bankTransfer' | 'bankTransferPending' | 'booked' | 'bookingPending' | 'cancelled' | 'capturePending' | 'captureReversalPending' | 'captureReversed' | 'captured' | 'capturedExternally' | 'chargeback' | 'chargebackExternally' | 'chargebackPending' | 'chargebackReversalPending' | 'chargebackReversed' | 'credited' | 'depositCorrection' | 'depositCorrectionPending' | 'dispute' | 'disputeClosed' | 'disputeExpired' | 'disputeNeedsReview' | 'error' | 'expired' | 'failed' | 'fee' | 'feePending' | 'internalTransfer' | 'internalTransferPending' | 'invoiceDeduction' | 'invoiceDeductionPending' | 'manualCorrectionPending' | 'manuallyCorrected' | 'matchedStatement' | 'matchedStatementPending' | 'merchantPayin' | 'merchantPayinPending' | 'merchantPayinReversed' | 'merchantPayinReversedPending' | 'miscCost' | 'miscCostPending' | 'paymentCost' | 'paymentCostPending' | 'received' | 'refundPending' | 'refundReversalPending' | 'refundReversed' | 'refunded' | 'refundedExternally' | 'refused' | 'reserveAdjustment' | 'reserveAdjustmentPending' | 'returned' | 'secondChargeback' | 'secondChargebackPending' | 'undefined', required — The result of the transfer. For example, **authorised**, **refused**, or **error**.

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `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

- **2023-12-20** (v3) `ec02d539f754` — 3 warning, 1 info
  - the `counterparty/bankAccount/accountHolder/reference` request property's maxLength was set to `150`
  - the `description` request property's maxLength was set to `140`
  - the `ultimateParty/reference` request property's maxLength was set to `150`
  - the endpoint scheme security `clientKey` was added to the API
- **2023-10-27** (v3) `073f244a0263` — 3 breaking, 6 warning, 3 info
  - removed the enum value `directDebit` of the request property `priority`
  - the `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/HKLocalAccountIdentification]/accountNumber` response property's maxLength was increased from `12` to `15` for the response status `200`
  - the `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/HKLocalAccountIdentification]/accountNumber` response property's maxLength was increased from `12` to `15` for the response status `202`
  - removed the optional property `response/paths` from the response with the `403` status
  - …8 more
- …earlier changes not shown

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

---

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