Протокол массовых выплат устарел. Если хотите делать выплаты по API, используйте [API ЮKassa](/developers/payouts/overview). ЮKassa ежедневно формирует реестры успешных и возвращенных выплат. В реестрах — все операции за указанную дату (в период с 00:00:00 по 23:59:59 по московскому времени): * в **реестре успешных выплат** — все зачисленные выплаты; * в **реестре возвращенных выплат** — все возвращенные (полностью и частично) выплаты. Реестры приходят на электронную почту, которую вы сообщили менеджеру при подключении. Реестры успешных и возвращенных выплат приходят разными письмами. Если за указанную дату не было совершено никаких операций, придет пустой реестр.

Письма подписываются сертификатом ЮKassa (S/MIME подпись). Тема электронного письма формируется по шаблону (нумерация сквозная):

Во вложении к письму реестр в двух файлах: * в [формате CSV](#csv) — для автоматической обработки; * в [формате XLS](#xls) — для разбора вручную. **Формат имени файла реестра успешных выплат**

**Формат имени файла реестра возвращенных выплат**

Реестр содержит: * заголовок с номером и датой реестра; * перечень зачисленных или возвращенных выплат; * сводную информацию по выплатам, включая баланс обеспечительного счета.

Формат файла реестра соответствует [рекомендации IETF RFC4180](http://tools.ietf.org/html/rfc4180). Разделитель полей — точка с запятой «;». Кодировка символов — UTF‑8. Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"», точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"». Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.

Содержимое файла реестра состоит из следующих элементов: * [HD-строка](#csv-hd) — заголовок реестра; * [D-строки](#csv-d) — информация о выплатах; * [TD-строка](#csv-td) — контрольная строка, сумма всех выплат за указанный период; * — маркер отсутствия выплат (присутствует, если за указанный период не было никаких операций).

Заголовок реестра содержит идентификатор магазина в ЮKassa, номер реестра (идентификатор реестра) и отчетный период, за который сформирован реестр.

``` HD;registerId;agentId;from;till ```

Параметр	Тип	Описание
registerId	xs:long	Идентификатор сформированного реестра, уникальный на протяжении всей истории операций.
agentId	xs:long	Идентификатор вашего шлюза в ЮKassa.
from	xs:dateTime	Начало отчетного периода, за который сформирован реестр, включительно («от» включая). Дата и время в формате ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)).
till	xs:dateTime	Конец отчетного периода, за который сформирован реестр, исключительно («до» не включая). Дата и время в формате ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)).

``` HD;123456;2277;2015-07-01T00:00:00.000+03:00;2015-07-02T00:00:00.000+03:00 ```

Для каждой операции, проведенной за отчетный период, формируется отдельная D-строка.

``` D;clientOrderId;amount;currency;dstAccount;processedDT;comission;comissionCurrencyCode ```

Параметр	Тип	Описание
dstAccount	YMAccount	Идентификатор получателя перевода, значение параметра из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
clientOrderId	ClientTransactionNumber	Уникальный номер транзакции в ЮKassa (string, до 32 символов). Значение параметра из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
processedDT	xs:dateTime	Время зачисления на счет получателя, приходит в ответе на [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics). В случае возврата — время проведения операции возврата денег со счета получателя выплаты. Дата и время по часам ЮKassa в формате ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)).
amount	CurrencyAmount	Сумма выплаты или возврата. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
currency	CurrencyCode	Код валюты транзакции — целое беззнаковое число. Например: — рубль РФ.
comission	CurrencyAmount	Сумма комиссии, которую ЮKassa списала за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Может отсутствовать, если вы подключились до августа 2019 г. Чтобы получать в реестрах информацию о комиссиях, напишите вашему менеджеру.
comissionCurrency	CurrencyCode	Код валюты комиссии — целое беззнаковое число. Например: — рубль РФ.

``` D;123;107.00;643;410010000400;2015-07-01T10:52:01.000+03:00;3.21;643 ```

Контрольная строка представляет собой сумму всех переводов по текущему реестру. Если переводов в указанный период не было, то реестр считается пустым и контрольная строка отсутствует. Пустой реестр содержит только строку заголовка и нулевую строку (Z-строку).

``` TD;count;sum;currency;comissionSum;comissionCurrency ```

Параметр	Тип	Описание
count	xs:int	Количество выплат за указанный период.
sum	CurrencyAmount	Общая сумма выплат за указанный период.
currency	CurrencyCode	Код валюты общей суммы.
comissionSum	CurrencyAmount	Общая сумма комиссии за указанный период.
comissionCurrency	CurrencyCode	Код валюты общей суммы комиссии.

``` TD;86;88230.95;643;1163.25;643 ```

**Пример реестра** ``` HD;123456;2277;2019-07-08T00:00:00.000+03:00;2019-07-09T00:00:00.000+03:00 D;123;107.00;643;41001000040;2019-07-08T08:49:48.648+03:00;3.21;643 D;124;200.00;643;41001000040;2019-07-08T10:37:39.974+03:00;6.00;643 TD;2;307.95;643;9.21;643 ``` **Пример пустого реестра** ``` HD;123456;2277;2015-07-01T00:00:00.000+03:00;2015-07-02T00:00:00.000+03:00 Z ``` **Примеры файлов** Пример реестра успешных выплат: [settlement_file_123456_08.07.2019_2000013203127.csv](https://yookassa.ru/docs/registers/settlement_file_123456_2019-07-08_2000013203127.csv) Пример реестра возвращенных выплат: [refund_123456_08.07.2019_2000013203129.csv](https://yookassa.ru/docs/registers/refund_123456_2019-07-08_2000013203129.csv) Пример пустого реестра: [settlement_file_123456_08.07.2019_2000013203128.csv](https://yookassa.ru/docs/registers/settlement_file_123456_2019-07-08_2000013203128.csv)

Поле	Значение
Заголовок
AGENT ID	Идентификатор вашего шлюза в ЮKassa.
Дата	Дата в формате В реестр попадают выплаты, датированные этим числом.
№	Порядковый номер реестра.
Таблица
Номер транзакции	Уникальный номер транзакции в ЮKassa (string, до 32 символов). Значение параметра из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
Сумма	Сумма транзакции. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
Валюта	Валюта транзакции. Трехбуквенный код, например: — рубль РФ.
Идентификатор получателя	Идентификатор получателя перевода, значение параметра из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
Дополнительные реквизиты	Одно из трех значений, зависит от назначения выплаты. На банковский счет: номер банковского счета получателя. На банковскую карту: [синоним номера банковской карты](/docs/payment-solution/payouts/api/make-deposition/bank-card#card-synonym). На баланс мобильного: * — код оператора мобильной связи; * — номер телефона. и передаются в склеенном виде. Присутствуют, если были переданы в запросе [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics).
ФИО получателя	Данные получателя перевода из запроса [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics): * — фамилия; * — имя; * — отчество. Передаются в склеенном виде, только для выплат на банковские карты или счет.
Время перевода	Время зачисления на счет получателя, приходит в ответе на [makeDeposition](/docs/payment-solution/payouts/api/make-deposition/basics). В случае возврата — время проведения операции возврата денег со счета получателя выплаты. Дата и время по часам ЮKassa в формате ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)).
Назначение	Счет, на который зачисляются деньги. Варианты: * Кошелек ЮMoney; * Банковская карта; * Банковский счет; * Баланс мобильного телефона.
Комиссия	Сумма комиссии, которую ЮKassa списала за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Может отсутствовать, если вы подключились до августа 2019 г. Чтобы получать в реестрах информацию о комиссиях, напишите вашему менеджеру.
Валюта комиссии	Трехбуквенный код, например: — рубль РФ.
Контрольная строка
Баланс счета	Сумма обеспечения баланса выплат на момент формирования реестра.

Зачисление переводов