Список в формате CSV

Вы можете делать выплаты через личный кабинет с помощью файлов формата XLSX и CSV. Если вы хотите заполнять данные вручную, рекомендуется использовать файл в формате XLSX. Если вы ведете учет получателей выплат в специальной программе, например, в CRM, можно выгрузить данные прямо оттуда в файл CSV и загрузить его в личный кабинет.

Из этой статьи вы узнаете, как правильно заполнить файл CSV:

Требования к формату

Формат файла реестра соответствует рекомендации IETF RFC4180. Разделитель полей — точка с запятой «;». Кодировка символов — UTF-8.

Note. Рекомендуется использовать UTF-8 с BOM, чтобы файл можно было открыть и проверить в Microsoft Excel.

Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"», точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"».

Note. Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.

Структура файла

Содержимое файла реестра состоит из следующих элементов:

  • HD-строка — заголовок реестра;
  • D-строки — данные о выплатах.
Заголовок (HD-строка)

Заголовок реестра всегда должен быть следующим:

HD;№;Тип;"Уникальный номер выплаты";Сумма;Валюта;"Номер банковской карты";"Номер кошелька";"Расчётный счёт";БИК;Наименование;"Город отделения";"Корр. счёт";Телефон;Фамилия;Имя;Отчество;"Серия и номер паспорта";"Дата выдачи паспорта";"Дата рождения";"Получатель согласен с офертой?";"Гражданство получателя";Город;Улица;Дом;Квартира;Индекс
            
Данные для выплат (D-строка)

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

Описание полей

Поле

Описание

Обязательность заполнения

Тип строки

Тип строки в CSV-файле. Возможное значение: D — строка выплат

Для всех видов выплат

Номер выплаты в списке

Номер выплаты в вашем списке. Этот номер Яндекс.Касса будет использовать в сообщениях об ошибках при загрузке файла

Для всех видов выплат

Тип

Вид выплаты в Яндекс.Кассе. Возможные значения:

  • card — выплата на банковскую карту;
  • wallet — выплата на кошелек в Яндекс.Деньгах;
  • bank — выплата на банковский счет;
  • tel — выплата на номер мобильного телефона

Для всех видов выплат

Уникальный номер выплаты

Идентификатор, уникальный для всех ваших выплат. Отображается в истории выплат в личном кабинете

Для всех видов выплат

Сумма

Сумма выплаты. Минимальное и максимальное значение зависит от вида выплаты. Формат: десятичное число с двумя знаками после запятой, разделитель — точка или запятая

Для всех видов выплат

Валюта

Валюта выплаты. Возможное значение: 643 — российский рубль

Для всех видов выплат

Номер банковской карты

Номер банковской карты, на которую нужно сделать выплату. Формат: 16 или 18 цифр без пробелов

Для выплат на банковскую карту

Номер кошелька

Номер кошелька, на который нужно сделать выплату. Формат: от 12 до 16 цифр без пробелов, номер начинается с 41001

Для выплат на кошелек в Яндекс.Деньгах

Расчётный счёт

Номер расчетного счета, на который нужно сделать выплату. Формат: 20 цифр без пробелов

Для выплат на банковский счет

БИК

БИК банка. Формат: 9 цифр без пробелов

Для выплат на банковский счет

Наименование

Наименование банка.

Для выплат на банковский счет

Город отделения

Город, в котором находится отделение банка.

Для выплат на банковский счет

Корр. счёт

Корреспондентский счет отделения банка. Формат: 20 цифр без пробелов

Для выплат на банковский счет

Телефон

Номер телефона получателя выплаты. Формат: номер начинается с 8, количество цифр зависит от вида выплат:

  • выплаты на телефон — максимум 11 цифр;
  • выплаты на карту или банковский счет — максимум 15 цифр

Для выплат на банковскую карту, банковский счет и номер мобильного телефона

Фамилия

Фамилия получателя (строго как в паспорте)

Для выплат на банковскую карту и банковский счет

Имя

Имя получателя (строго как в паспорте)

Для выплат на банковскую карту и банковский счет

Отчество

Отчество получателя, если оно есть в паспорте

Для выплат на банковскую карту и банковский счет

Серия и номер паспорта

Серия и номер российского общегражданского паспорта. Формат: 10 цифр без пробелов

Для выплат на банковскую карту и банковский счет

Дата выдачи паспорта

Дата выдачи паспорта получателя. Формат: ДД.ММ.ГГГГ

Для выплат на банковскую карту и банковский счет

Дата рождения

Дата рождения получателя. Формат: ДД.ММ.ГГГГ

Для выплат на банковскую карту и банковский счет

Получатель согласен с офертой?

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

Для выплат на банковскую карту, банковский счет и номер мобильного телефона

Гражданство получателя

Гражданство. Возможное значение: РФ

Для выплат на банковскую карту и банковский счет

Город

Город получателя выплаты. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Улица

Улица получателя выплаты. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Дом

Номер дома получателя выплаты, при необходимости здесь же указывается литера и корпус. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Квартира

Квартира получателя выплаты (при наличии). Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Индекс

Индекс получателя. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Поле

Описание

Обязательность заполнения

Тип строки

Тип строки в CSV-файле. Возможное значение: D — строка выплат

Для всех видов выплат

Номер выплаты в списке

Номер выплаты в вашем списке. Этот номер Яндекс.Касса будет использовать в сообщениях об ошибках при загрузке файла

Для всех видов выплат

Тип

Вид выплаты в Яндекс.Кассе. Возможные значения:

  • card — выплата на банковскую карту;
  • wallet — выплата на кошелек в Яндекс.Деньгах;
  • bank — выплата на банковский счет;
  • tel — выплата на номер мобильного телефона

Для всех видов выплат

Уникальный номер выплаты

Идентификатор, уникальный для всех ваших выплат. Отображается в истории выплат в личном кабинете

Для всех видов выплат

Сумма

Сумма выплаты. Минимальное и максимальное значение зависит от вида выплаты. Формат: десятичное число с двумя знаками после запятой, разделитель — точка или запятая

Для всех видов выплат

Валюта

Валюта выплаты. Возможное значение: 643 — российский рубль

Для всех видов выплат

Номер банковской карты

Номер банковской карты, на которую нужно сделать выплату. Формат: 16 или 18 цифр без пробелов

Для выплат на банковскую карту

Номер кошелька

Номер кошелька, на который нужно сделать выплату. Формат: от 12 до 16 цифр без пробелов, номер начинается с 41001

Для выплат на кошелек в Яндекс.Деньгах

Расчётный счёт

Номер расчетного счета, на который нужно сделать выплату. Формат: 20 цифр без пробелов

Для выплат на банковский счет

БИК

БИК банка. Формат: 9 цифр без пробелов

Для выплат на банковский счет

Наименование

Наименование банка.

Для выплат на банковский счет

Город отделения

Город, в котором находится отделение банка.

Для выплат на банковский счет

Корр. счёт

Корреспондентский счет отделения банка. Формат: 20 цифр без пробелов

Для выплат на банковский счет

Телефон

Номер телефона получателя выплаты. Формат: номер начинается с 8, количество цифр зависит от вида выплат:

  • выплаты на телефон — максимум 11 цифр;
  • выплаты на карту или банковский счет — максимум 15 цифр

Для выплат на банковскую карту, банковский счет и номер мобильного телефона

Фамилия

Фамилия получателя (строго как в паспорте)

Для выплат на банковскую карту и банковский счет

Имя

Имя получателя (строго как в паспорте)

Для выплат на банковскую карту и банковский счет

Отчество

Отчество получателя, если оно есть в паспорте

Для выплат на банковскую карту и банковский счет

Серия и номер паспорта

Серия и номер российского общегражданского паспорта. Формат: 10 цифр без пробелов

Для выплат на банковскую карту и банковский счет

Дата выдачи паспорта

Дата выдачи паспорта получателя. Формат: ДД.ММ.ГГГГ

Для выплат на банковскую карту и банковский счет

Дата рождения

Дата рождения получателя. Формат: ДД.ММ.ГГГГ

Для выплат на банковскую карту и банковский счет

Получатель согласен с офертой?

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

Для выплат на банковскую карту, банковский счет и номер мобильного телефона

Гражданство получателя

Гражданство. Возможное значение: РФ

Для выплат на банковскую карту и банковский счет

Город

Город получателя выплаты. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Улица

Улица получателя выплаты. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Дом

Номер дома получателя выплаты, при необходимости здесь же указывается литера и корпус. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Квартира

Квартира получателя выплаты (при наличии). Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Индекс

Индекс получателя. Указывает адрес фактического проживания

Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет

Примеры строк с данными для выплат

Выплата до 15 000 рублей на карту российского банка

D;1;card;example_payout_20190101_1;100.00;643;ХХХХХХХХХХХХХХХХ;;;;;;;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;;;;;

Выплата более 15 000 рублей или выплата на карту иностранного банка

D;2;card;example_payout_20190101_2;100.00;643;ХХХХХХХХХХХХХХХХ;;;;;;;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;Санкт-Петербург;Ленина;"22а/1 к1";33;100291

Выплата на кошелек

D;3;wallet;example_payout_20190101_3;1.00;643;;41001ХХХХХХХХХХХ;;;;;;;;;;;;;;;;;;;

Выплата до 15 000 рублей на банковский счет

D;4;bank;example_payout_20190101_4;20.00;643;;;XXXXXXXXXXXXXXXXXXXX;XXXXXXXXX;"ПАО Сбербанк";Москва;XXXXXXXXXXXXXXXXXXXX;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;;;;;

Выплата более 15 000 рублей на банковский счет

D;5;bank;example_payout_20190101_5;20.00;643;;;XXXXXXXXXXXXXXXXXXXX;XXXXXXXXX;"ПАО Сбербанк";Москва;XXXXXXXXXXXXXXXXXXXX;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;Санкт-Петербург;Ленина;"22а/1 к1";33;100291

Выплата на номер мобильного телефона

D;6;tel;example_payout_20190101_6;1.00;643;;;;;;;;8ХХХХХХХХХХ;;;;;;;Да;;;;;;

Шаблон файла

Инструкция по заполнению файла

Шаг 1. Добавьте заголовок — HD-строку.

Шаг 2. Добавьте информацию о выплатах — D-строки. Количество строк может быть любым. В одном файле могут быть выплаты разных видов (на кошелек, карту, счёт и телефон). Порядок может быть любым, но рекомендуется группировать выплаты по видам, например, сначала перечислить в файле все выплаты на банковские карты, затем все выплаты на кошелек и так далее. Так вам будет проще ориентироваться в данных.

Шаг 3. Сохраните файл. Название файла может быть любым.

Шаг 4. Проверьте себя:

  • В каждой D-строке 27 полей.
  • Данные заполнены в нужном порядке.
  • Данные заполнены в зависимости от вида выплат, лишние поля пустые.
  • Данные указаны в нужном формате.
  • Сумма выплаты соответствует лимитам.
  • Получатели выплат на карты, счета или телефоны приняли оферту.
  • Получатели выплат на карты и счета — граждане РФ.
  • При выплате на карту иностранного банка или при выплате более 15 000 рублей на карту российского банка или банковский счет указан адрес фактического проживания получателя.
  • Файл сохранен в формате CSV и кодировке UTF-8.
    Note. Рекомендуется использовать UTF-8 с BOM, чтобы файл можно было открыть и проверить в Microsoft Excel.
  • Размер файла не более 2 Мбайт.

Готово! Можно загружать файл в личный кабинет. Если где-то будет ошибка, Яндекс.Касса укажет порядковый номер выплаты и расскажет, что нужно поправить. Если всё корректно, Яндекс.Касса сформирует хеш загруженного файла по алгоритму SHA-256, отобразит хеш и общую сумму выплат. Вам останется только проверить по хешу и сумме, что загружена актуальная версия файла, и подтвердить по смс проведение выплат.

Смотрите также

Выплаты по спискам (XLSX)

Реестры успешных и возвращенных выплат

Выплаты по протоколу