---
title: "Start a balance transfer"
method: POST
path: "/balanceTransfer"
tags: ["General"]
deprecated: true
---

# Start a balance transfer

`POST /balanceTransfer`

> **Deprecated.**

Starts a balance transfer request between merchant accounts. The following conditions must be met before you can successfully transfer balances:

* The source and destination merchant accounts must be under the same company account and legal entity.

* The source merchant account must have sufficient funds.

* The source and destination merchant accounts must have at least one common processing currency.

When sending multiple API requests with the same source and destination merchant accounts, send the requests sequentially and *not* in parallel. Some requests may not be processed if the requests are sent in parallel.

## Request body

- BalanceTransferRequest
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    - `value` integer, required — The amount of the transaction, 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 may be truncated.
  - `fromMerchant` string, required — The unique identifier of the source merchant account from which funds are deducted.
  - `reference` string — A reference for the balance transfer. If you don't provide this in the request, Adyen generates a unique reference. Maximum length: 80 characters.
  - `toMerchant` string, required — The unique identifier of the destination merchant account from which funds are transferred.
  - `type` 'tax' | 'fee' | 'terminalSale' | 'credit' | 'debit' | 'adjustment', required — The type of balance transfer. Possible values: **tax**, **fee**, **terminalSale**, **credit**, **debit**, and **adjustment**.

## Response `200`

OK - the request has succeeded.

- BalanceTransferResponse
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `createdAt` string, date-time, required — The date when the balance transfer was requested.
  - `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.
  - `fromMerchant` string, required — The unique identifier of the source merchant account from which funds are deducted.
  - `pspReference` string, required — Adyen's 16-character string reference associated with the balance transfer.
  - `reference` string — A reference for the balance transfer. If you don't provide this in the request, Adyen generates a unique reference. Maximum length: 80 characters.
  - `status` 'error' | 'failed' | 'notEnoughBalance' | 'transferred', required — The status of the balance transfer. Possible values: **transferred**, **failed**, **error**, and **notEnoughBalance**.
  - `toMerchant` string, required — The unique identifier of the destination merchant account from which funds are transferred.
  - `type` 'tax' | 'fee' | 'terminalSale' | 'credit' | 'debit' | 'adjustment', required — The type of balance transfer. Possible values: **tax**, **fee**, **terminalSale**, **credit**, **debit**, and **adjustment**.

## Changes

- **2025-03-05** (v1) `c8a8d2f58b52` — 1 info
  - endpoint deprecated
- **2023-02-24** (v1) `1a219a6d60bf` — 4 breaking
  - the request's body type changed from no type to `object`
  - the `amount` request property type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the `amount` response's property type changed from no type to `object` for status `200`

[Change history](https://skmtc.dev/adyen/apis/adyen-balance-control-api/changes/balanceTransfer/post.md)

---

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