--- metadata: - name: generator content: Diplodoc Platform v5.50.2 alternate: - https://yandex.com/dev/direct/doc/dg-v4/en/concepts/shared-account-howto.md - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/shared-account-howto.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt # Работа с общим счетом ## Подключение общего счета {#turn-on} Подключение общего счета и любые операции с ним невозможны, если у рекламодателя нет ни одной кампании. Прямые рекламодатели и клиенты агентств могут подключить общий счет только в веб-интерфейсе. Агентство может подключать общий счет своим клиентам с помощью метода [EnableSharedAccount (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/EnableSharedAccount.md). Узнать, подключен ли у рекламодателя общий счет, можно с помощью методов [GetClientInfo (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetClientInfo.md) и [GetClientsList (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetClientsList.md) (результирующий параметр SharedAccountEnabled). Получить данные общего счета можно с помощью метода [AccountManagement (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement.md) (операция [Get](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Get.md)). Отключение общего счета недоступно. ## Пополнение общего счета {#top-up} Метод [AccountManagement (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement.md) позволяет: - пополнить общий счет из кредитного лимита агентства или из овердрафта рекламодателя (операция [Deposit](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Deposit.md)); - выставить счет на оплату (операция [Invoice](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Invoice.md)); - перевести средства между общими счетами клиентов агентства (операция [TransferMoney](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_TransferMoney.md)). {% note alert %} Прямой рекламодатель может пополнить общий счет только при наличии хотя бы одной кампании, прошедшей модерацию. {% endnote %} В течение переходного периода старые финансовые методы [PayCampaigns (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/PayCampaigns.md), [CreateInvoice (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateInvoice.md), [TransferMoney (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/TransferMoney.md) работают с общим счетом следующим образом. Если при вызове метода указан номер кампании, владелец которой уже подключил общий счет, то средства будут зачислены на общий счет (или, соответственно, списаны с общего счета). При этом для метода [TransferMoney (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/TransferMoney.md) действует дополнительное ограничение: метод может использоваться агентствами для перевода средств между **двумя** клиентами, один из которых (или оба) используют общий счет. Если при вызове метода указаны кампании более чем двух клиентов и хотя бы у одного из этих клиентов подключен общий счет, возвращается сообщение об ошибке с кодом [353](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#errorCode353). ## Дневной бюджет {#daybudget} Необязательная структура AccountDayBudget содержит параметры Amount и SpendMode. Сброс дневного бюджета осуществляется при передаче значения 0 в параметре Amount. ## Настройки информирования {#settings} Настроить информирование о событиях, связанных с общим счетом, можно с помощью метода [AccountManagement (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement.md) (операция [Update](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Update.md)). Настройки информирования на общем счете и на кампаниях применяются следующим образом. #| || **Параметры** | **Для общего счета** | **Для кампании** || || `MoneyInSms`, `MoneyOutSms`, `MoneyWarningValue` | Настраиваются только для общего счета, так как соответствующие события относятся к общему счету. | Не используются при подключенном общем счете. Методы [GetCampaignParams (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetCampaignParams.md) и [GetCampaignsParams (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetCampaignsParams.md) возвращают значения соответствующих параметров общего счета. || || `PausedByDayBudget`, `PausedByDayBudgetSms` | Настраиваются только для общего счета, так как соответствующие события относятся к общему счету. | Не используются. || || `SmsTimeFrom`, `SmsTimeTo` | Указывают допустимый интервал времени для SMS-информирования о зачислении и исчерпании средств на общем счете. | Указывают допустимый интервал времени для SMS-информирования о событиях, связанных с кампанией: результатах мониторинга сайтов и модерации объявлений. || || `Email` | Адрес электронной почты для информирования о событиях, связанных с общим счетом. | Адрес электронной почты для информирования о событиях, связанных с кампанией. || |# ## Финансовый токен {#token} При выполнении операций [Deposit](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Deposit.md), [Invoice](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Invoice.md) и [TransferMoney](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_TransferMoney.md) метода [AccountManagement (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement.md) необходимо указывать порядковый номер операции и финансовый токен. При формировании финансового токена для этих операций в дополнение к названию метода необходимо указать также название операции. Таким образом, финансовый токен представляет собой зашифрованную методом SHA256 строку, полученную конкатенацией следующих подстрок: - мастер-токен; - номер операции (параметр operation_num); - название метода: AccountManagement; - название операции: Deposit, Invoice или TransferMoney; ## Узнайте больше - [Общий счет (Account)](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/shared-account.md)