---
title: "Transfer funds between platform accounts"
method: POST
path: "/transferFunds"
tags: ["General"]
---

# Transfer funds between platform accounts

`POST /transferFunds`

Transfers funds from one account to another account. Both accounts must be in the same platform, but can have different account holders. The transfer must include a transfer code, which should be determined by the platform, in compliance with local regulations.

## Request body

- TransferFundsRequest
  - `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).
  - `destinationAccountCode` string, required — The code of the account to which the funds are to be credited. >The state of the Account Holder of this account must be Active.
  - `merchantReference` string — A value that can be supplied at the discretion of the executing user in order to link multiple transactions to one another.
  - `sourceAccountCode` string, required — The code of the account from which the funds are to be debited. >The state of the Account Holder of this account must be Active and allow payouts.
  - `transferCode` string, required — The code related to the type of transfer being performed. >The permitted codes differ for each platform account and are defined in their service level agreement.

## Response `200`

OK - the request has succeeded.

- TransferFundsResponse
  - `merchantReference` string — The value supplied by the executing user when initiating the transfer; may be used to link multiple transactions.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `400` — Bad Request - a problem reading or understanding the request.
- `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.

---

[API](https://skmtc.net/adyen/apis/fundservice.md) · [All operations](https://skmtc.net/adyen/apis/fundservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/fundservice/versions/9b4819139946/schema)