---
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 transfer request to move funds within your balance platform, or send funds to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/v1/post/transferInstruments). 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

- `Idempotency-Key` string
- `WWW-Authenticate` string

## Request body

- TransferInfoOld
  - `amount` Amount, required
    - `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).
  - `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 will be truncated in the webhooks that you receive about the transfer.
  - `destination` PartyIdentification, required
    - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `paymentInstrumentId` string — The unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).
  - `reference` string — Your unique reference for the transfer. You can use alphanumeric characters and hyphens.
  - `source` InternalPartyIdentification, required
    - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `paymentInstrumentId` string — The unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).

## Response `200`

OK - the request has succeeded.

- TransferOld
  - `amount` Amount, required
    - `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).
  - `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 will be truncated in the webhooks that you receive about the transfer.
  - `destination` PartyIdentification, required
    - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `paymentInstrumentId` string — The unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).
  - `id` string, required — Unique identifier of the transfer.
  - `reference` string — Your unique reference for the transfer. You can use alphanumeric characters and hyphens.
  - `refusalReason` string — Additional information about the result of the transfer request.
  - `resultCode` string, required — The result of the transfer request. Possible values: **Authorised**, **Refused**.
  - `source` InternalPartyIdentification, required
    - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `paymentInstrumentId` string — The unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/paymentInstruments__resParam_id).

## Other responses

- `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

- **2024-10-30** (v1) `e9e1cc8dbd97` — 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2024-06-05** (v1) `ffa62583a3ce` — 3 info
  - added the optional property `routingDetails` to the response with the `403` status
  - added the optional property `routingDetails` to the response with the `422` status
  - added the optional property `routingDetails` to the response with the `500` status
- **2023-12-20** (v1) `b6626bee4e9b` — 1 info
  - the endpoint scheme security `clientKey` was added to the API
- **2023-10-27** (v1) `6a461735ce65` — 6 warning
  - removed the optional property `response/paths` from the response with the `403` status
  - removed the optional property `response/paths` from the response with the `422` status
  - removed the optional property `response/paths` from the response with the `500` status
  - removed the optional property `response/rootPath` from the response with the `403` status
  - …2 more
- **2023-09-27** (v1) `e8d0f4dc4d40` — 5 breaking, 4 warning, 4 info
  - the response property `errorCode` became optional for the status `401`
  - the response property `status` became optional for the status `401`
  - removed the required property `detail` from the response with the `401` status
  - removed the required property `title` from the response with the `401` status
  - …9 more

[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-service-production.skmtc.workers.dev/v1/apis/adyen/transferservice/revisions/13735824b8e3/schema)