---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/AccountManagement_TransferMoney.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_TransferMoney.md
  - href: en/live/AccountManagement_TransferMoney.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/en/llms.txt

# TransferMoney
Transfers funds between clients' shared accounts.
This method is only available to advertising agencies.

There is a slight delay before transferring funds, usually no more than five minutes.

## Restrictions

Funds can be transferred from one client's shared account to another client's shared account, provided they both use the same currency.

Only one transfer can be made in a single call of the action.

No more than 3 transfers per day can be made for a single account.

## Input data

The input data structure in JSON is shown below.


{% note alert %}

It is mandatory to include the `finance_token` and `operation_num` parameters in the request. For information on generating the token, see the section [Working with the shared account](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/shared-account-howto.md).

{% endnote %}


```javascript
{
   "method": "AccountManagement",
   "finance_token": (string),
   "operation_num": (int),
   "param": {
      /* AccountManagementRequest */
      "Action": (string),
      "Transfers": [
         {  /* Transfer */
            "FromAccountID": (int),
            "ToAccountID": (int),
            "Amount": (float),
            "Currency": (string)
         }
         ...
      ]
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
|
**<sup >Required</sup>**
||

||
**<sub >AccountManagementRequest object</sub>**
||
||
`Action`
|
Action: TransferMoney.
|
Yes
||
||
`Transfers`
|
Array containing a single `Transfer` object.
|
Yes
||

||
**<sub >Transfer object</sub>**
||
||
`FromAccountID`
|
ID of the shared account that funds are being deducted from.
|
Yes
||
||
`ToAccountID`
|
ID of the shared account that funds are being deposited to.
|
Yes
||
||
`Amount`
|
The transfer amount (in the currency specified in the `Currency` parameter). For a value in a real currency, don't include VAT.

Before deducting or crediting the amount, it is mathematically rounded to the second decimal point (for all currencies, including the tenge).

Use the [Get](https://yandex.com/dev/direct/doc/dg-v4/en/live/AccountManagement_Get.md) operation to find out the amount available for transfer.
|
Yes
||
||
`Currency`
|
The currency that the amount is shown in.

Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. The value must match the currency of the shared account; otherwise, an error is returned with code [245](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#BadCurrency).
|
Yes
||
|#

## Output data

The output data structure in JSON is shown below.

```javascript
{
   "data": {
      /* AccountManagementResponse */
      "ActionsResult": [
         {  /* AccountActionResult */
            
            "AccountID": (int)
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ]
         }
         ...
      ]
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
||

||
**<sub >AccountManagementResponse object</sub>**
||
||
`ActionsResult`
|
Array of `AccountActionResult` objects. Each object corresponds to an item in the `Transfers` input array and contains:

- The ID of the shared account, if the transfer was successful.
- The `Errors` array, if an error occurred.

The items in the array are in the same order as the objects in the `Transfers` input array.
||

||
**<sub >AccountActionResult object</sub>**
||
||
`AccountID`
|
ID of the shared account that funds were deducted from.
||
||
`Errors`
|
Array of `Error` objects with errors that occurred while transferring funds.
||

||
**<sub >Error object</sub>**
||
||
`FaultCode`
|
Error code.
||
||
`FaultString`
|
Textual message about the error.
||
||
`FaultDetail`
|
Detailed description of the reason for the error.
||
|#

## Examples of input data

# Python

```python
{
   'Action': 'TransferMoney',
   'Transfers': [
      {
         'FromAccountID': 1327837,
         'ToAccountID': 1327944,
         'Amount': 25000.0,
         'Currency': 'RUB'
      }
   ]
}
```

# PHP

```php
array(
   'Action' => 'TransferMoney',
   'Transfers' => array(
      array(
         'FromAccountID' => 1327837,
         'ToAccountID' => 1327944,
         'Amount' => 25000.0,
         'Currency' ='RUB'
      )
   )
)
```

# Perl

```perl
{
   'Action' => 'TransferMoney',
   'Transfers' => [
      {
         'FromAccountID' => 1327837,
         'ToAccountID' => 1327944,
         'Amount' => 25000.0,
         'Currency' ='RUB'
      }
   ]
}
```