---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/PayCampaigns.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/PayCampaigns.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# PayCampaigns
Оплата кампании из кредитного лимита рекламного агентства
Для метода существует версия [PayCampaigns (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/PayCampaigns.html).

Кредит предоставляется рекламным агентствам, с которыми заключены специальные кредитные договоры. Метод [GetCreditLimits](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetCreditLimits.md) возвращает информацию о предоставленных кредитах.

При оплате кампании за счет кредита автоматически формируется печатная форма счета на оплату, получить которую можно через интерфейс Яндекс Директа.


{% note alert %}

Прямые рекламодатели могут оплачивать кампанию, только если она одобрена модератором (см. параметр кампании StatusModerate).

{% endnote %}


## Рекомендации и ограничения

<!-- source: ru/reference/_includes/reference/CreateInvoice/id-CreateInvoice/campaign-types-pay.md -->
{% note alert %}

Все кампании, указанные в одном вызове метода, должны быть одного типа. [Подробнее о типах кампаний...](https://yandex.ru/dev/direct/doc/dg/objects/campaign.md)

{% endnote %}
<!-- endsource: ru/reference/_includes/reference/CreateInvoice/id-CreateInvoice/campaign-types-pay.md -->


Рекомендуется оплачивать кампании как можно меньшим количеством вызовов метода `PayCampaign` в сутки. Данная рекомендация нацелена на повышение производительности API Яндекс Директа. С точки зрения производительности, лучше оплатить несколько кампаний за один вызов метода, чем использовать его несколько раз для оплаты по одной кампании.

Ниже перечислены ограничения на вызов метода:

- один пользователь может вызвать метод 1000 раз в сутки;
- для одной кампании возможно не более 30 финансовых операций в сутки, включая формирование счетов на оплату ([CreateInvoice](CreateInvoice.html)), перевод средств ([TransferMoney](TransferMoney.html)), оплату за счет предоставленного кредита ([PayCampaigns](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/PayCampaigns.md));

Превышение указанных лимитов вызывает ошибку с кодом [56](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode56).


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.


{% note alert %}

В запрос необходимо включать параметры `finance_token` и `operation_num`. 

{% endnote %}


```javascript
{
   "method": "PayCampaigns",
   "finance_token": (string),
   "operation_num": (int),
   "param": {
      /* PayCampaignsInfo */
      "Payments": [
         {  /* PayCampElement */
            "CampaignID": (int),
            "Sum": (float)
         }
         ...
      ],
      "ContractID": (string),
      "PayMethod": (string)
   }
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
|
**<sup >Требуется</sup>**
||

||
**<sub >Объект PayCampaignsInfo</sub>**
||
||
`Payments`
|
Массив объектов `PayCampElement`. Каждый объект указывает кампанию и сумму, оплачиваемую за счет кредита.
|
Да
||
||
`ContractID`
|
Номер договора, по которому предоставлен кредит.
|
Да
||
||
`PayMethod`
|
Способ погашения кредита. Влияет на формирование счета на оплату. В настоящее время параметр должен иметь значение “Bank”, что означает банковский перевод.
|
Да
||

||
**<sub >Объект PayCampElement</sub>**
||
||
`CampaignID`
|
Идентификатор кампании.
|
Да
||
||
`Sum`
|
Сумма в условных единицах, оплачиваемая за счет кредита.
|
Да
||
|#


## Результирующие данные {#output}

В случае успеха возвращается значение 1, как показано в следующем примере.

```javascript
{
   "data": 1
}
```

При неверном запросе возможны ошибки с кодами [355](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#errorCode355), [356](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#errorCode355), [357](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#errorCode357).


## Примеры входных данных {#examples}

## Python

```python
{
   'Payments': [
      {'CampaignID': 3193279, 'Sum': 1200.0},
      {'CampaignID': 3193478, 'Sum': 700.0}
   ],
   'ContractID': '23452345/67',
   'PayMethod': 'Bank'
}
```

## PHP

```php
array(
   'Payments' => array(
      array('CampaignID' => 3193279, 'Sum' =1200.0)
      array('CampaignID' => 3193478, 'Sum' =700.0)
   ),
   'ContractID' => '23452345/67',
   'PayMethod' ='Bank'
)
```

## Perl

```perl
{
   'Payments' => [
      {'CampaignID' => 3193279, 'Sum' =1200.0}
      {'CampaignID' => 3193478, 'Sum' =700.0}
   ],
   'ContractID' => '23452345/67',
   'PayMethod' ='Bank'
}
```