TransferMoney
Переводит средства между общими счетами клиентов.
Метод доступен только рекламным агентствам.
Перевод средств выполняется с небольшой задержкой, обычно не превышающей пять минут.
Ограничения
Средства можно перевести с общего счета одного клиента на общий счет другого клиента, при условии что они работают в одной и той же валюте.
В рамках одного вызова операции можно выполнить только один перевод.
Для одного счета возможно не более 3 переводов в день.
Входные данные
Ниже показана структура входных данных в формате JSON.
{
"method": "AccountManagement",
"finance_token": (string),
"operation_num": (int),
"param": {
/* AccountManagementRequest */
"Action": (string),
"Transfers": [
{ /* Transfer */
"FromAccountID": (int),
"ToAccountID": (int),
"Amount": (float),
"Currency": (string)
}
...
]
}
}
Ниже приведено описание параметров.
Параметр | Описание | Требуется |
Объект AccountManagementRequest | ||
---|---|---|
Action | Выполняемая операция: TransferMoney. | Да |
Transfers | Массив, содержащий единственный объект Transfer. | Да |
Объект Transfer | ||
FromAccountID | Идентификатор общего счета, с которого списываются средства. | Да |
ToAccountID | Идентификатор общего счета, на который зачисляются средства. | Да |
Amount | Сумма перевода (в валюте, указанной в параметре Currency). Значение в реальной валюте следует указывать без учета НДС. Перед списанием/зачислением сумма округляется по математическим правилам с точностью до второго знака после запятой (для всех валют, в том числе тенге). Доступную для перевода сумму можно узнать с помощью операции Get. | Да |
Currency | Валюта, в которой указана сумма. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой общего счета, в противном случае возвращается ошибка с кодом 245. | Да |
Параметр | Описание | Требуется |
Объект AccountManagementRequest | ||
---|---|---|
Action | Выполняемая операция: TransferMoney. | Да |
Transfers | Массив, содержащий единственный объект Transfer. | Да |
Объект Transfer | ||
FromAccountID | Идентификатор общего счета, с которого списываются средства. | Да |
ToAccountID | Идентификатор общего счета, на который зачисляются средства. | Да |
Amount | Сумма перевода (в валюте, указанной в параметре Currency). Значение в реальной валюте следует указывать без учета НДС. Перед списанием/зачислением сумма округляется по математическим правилам с точностью до второго знака после запятой (для всех валют, в том числе тенге). Доступную для перевода сумму можно узнать с помощью операции Get. | Да |
Currency | Валюта, в которой указана сумма. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой общего счета, в противном случае возвращается ошибка с кодом 245. | Да |
Результирующие данные
Ниже показана структура результирующих данных в формате JSON.
{
"data": {
/* AccountManagementResponse */
"ActionsResult": [
{ /* AccountActionResult */
"AccountID": (int)
"Errors": [
{ /* Error */
"FaultCode": (int),
"FaultString": (string),
"FaultDetail": (string)
}
...
]
}
...
]
}
}
Ниже приведено описание параметров.
Параметр | Описание |
Объект AccountManagementResponse | |
---|---|
ActionsResult | Массив объектов AccountActionResult. Каждый объект соответствует элементу входного массива Transfers и содержит:
Элементы массива следуют в том же порядке, что и объекты входного массива Transfers. |
Объект AccountActionResult | |
AccountID | Идентификатор общего счета, с которого списаны средства. |
Errors | Массив объектов Error — ошибок, возникших при переводе средств. |
Объект Error | |
FaultCode | Код ошибки. |
FaultString | Текст сообщения об ошибке. |
FaultDetail | Подробное описание причины ошибки. |
Параметр | Описание |
Объект AccountManagementResponse | |
---|---|
ActionsResult | Массив объектов AccountActionResult. Каждый объект соответствует элементу входного массива Transfers и содержит:
Элементы массива следуют в том же порядке, что и объекты входного массива Transfers. |
Объект AccountActionResult | |
AccountID | Идентификатор общего счета, с которого списаны средства. |
Errors | Массив объектов Error — ошибок, возникших при переводе средств. |
Объект Error | |
FaultCode | Код ошибки. |
FaultString | Текст сообщения об ошибке. |
FaultDetail | Подробное описание причины ошибки. |
Примеры входных данных
Python
{
'Action': 'TransferMoney',
'Transfers': [
{
'FromAccountID': 1327837,
'ToAccountID': 1327944,
'Amount': 25000.0,
'Currency': 'RUB'
}
]
}
PHP
array(
'Action' => 'TransferMoney',
'Transfers' => array(
array(
'FromAccountID' => 1327837,
'ToAccountID' => 1327944,
'Amount' => 25000.0,
'Currency' => 'RUB'
)
)
)
Perl
{
'Action' => 'TransferMoney',
'Transfers' => [
{
'FromAccountID' => 1327837,
'ToAccountID' => 1327944,
'Amount' => 25000.0,
'Currency' => 'RUB'
}
]
}