Вы можете делать выплаты через личный кабинет с помощью файлов формата XLSX и CSV. Если вы хотите заполнять данные вручную, рекомендуется использовать файл в формате XLSX. Если вы ведете учет получателей выплат в специальной программе, например в CRM, можно выгрузить данные прямо оттуда в файл CSV и загрузить его в личный кабинет.
Из этой статьи вы узнаете, как правильно заполнить файл CSV:
- какие требования к формату файла,
- какой должна быть структура файла,
- какие есть нюансы при заполнении файла.
Формат файла реестра соответствует рекомендации IETF RFC4180. Разделитель полей — точка с запятой «;». Кодировка символов — UTF‑8.
Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"», точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"».
Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.
Содержимое файла реестра состоит из следующих элементов:
- HD-строка — заголовок реестра;
- D-строки — данные о выплатах.
Заголовок реестра всегда должен быть следующим:
HD;№;Тип;"Уникальный номер выплаты";Сумма;Валюта;"Номер банковской карты (или синоним)";"Номер кошелька";"Расчётный счёт";БИК;Наименование;"Город отделения";"Корр. счёт";Телефон;Фамилия;Имя;Отчество;"ИНН получателя(не обязательно)";"ОМС получателя(не обязательно)";"СНИЛС получателя(не обязательно)";"Серия и номер паспорта";"Дата выдачи паспорта";"Дата рождения";"Получатель согласен с офертой?";"Гражданство получателя";Город;Улица;Дом;Квартира;Индекс;"Идентификатор пользователя(не обязательно)"
Для каждой выплаты нужно сформировать отдельную D-строку. Общее количество полей всегда неизменно, количество заполненных полей зависит от вида выплаты.
| Поле | Описание | Обязательность заполнения |
|---|---|---|
| Тип строки | Тип строки в CSV-файле. Возможное значение: D — строка выплат | Для всех видов выплат |
| Номер выплаты в списке | Номер выплаты в вашем списке. Этот номер ЮKassa будет использовать в сообщениях об ошибках при загрузке файла | Для всех видов выплат |
| Тип | Вид выплаты в ЮKassa. Возможные значения:
| Для всех видов выплат |
| Уникальный номер выплаты | Идентификатор, уникальный для всех ваших выплат. Отображается в истории выплат в личном кабинете | Для всех видов выплат |
| Сумма | Сумма выплаты. Минимальное и максимальное значение зависит от вида выплаты. Формат: десятичное число с двумя знаками после запятой, разделитель — точка или запятая | Для всех видов выплат |
| Валюта | Валюта выплаты. Возможное значение: 643 — российский рубль | Для всех видов выплат |
| Номер банковской карты (или синоним) | Номер банковской карты, на которую нужно сделать выплату, или ее синоним, полученный с помощью формы ЮKassa. Формат номера карты: 16 или 18 цифр без пробелов | Для выплат на банковскую карту |
| Номер кошелька | Номер кошелька, на который нужно сделать выплату. Формат: от 12 до 16 цифр без пробелов, номер начинается с 41001 | Для выплат на кошелек ЮMoney |
| Расчётный счёт | Номер расчетного счета, на который нужно сделать выплату. Формат: 20 цифр без пробелов | Для выплат на банковский счет |
| БИК | БИК банка. Формат: 9 цифр без пробелов | Для выплат на банковский счет |
| Наименование | Наименование банка. | Для выплат на банковский счет |
| Город отделения | Город, в котором находится отделение банка. | Для выплат на банковский счет |
| Корр. счёт | Корреспондентский счет отделения банка. Формат: 20 цифр без пробелов | Для выплат на банковский счет |
| Телефон | Номер телефона получателя выплаты. Формат: номер начинается с 8, количество цифр зависит от вида выплат:
| Для выплат на банковскую карту, банковский счет и номер мобильного телефона |
| Фамилия | Фамилия получателя (строго как в паспорте). Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| Имя | Имя получателя (строго как в паспорте). Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| Отчество | Отчество получателя, если оно есть в паспорте. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| ИНН получателя (не обязательно) | ИНН получателя выплат. Пример: 123456789012Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. Необязательный параметр | Для выплат на банковскую карту и банковский счет |
| ОМС получателя (не обязательно) | Номер полиса ОМС. Пример: Пример: 12345678901234Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. Необязательный параметр | Для выплат на банковскую карту и банковский счет |
| СНИЛС получателя (не обязательно) | СНИЛС получателя выплат (только цифры, без пробелов). Пример: 12345678901Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. Необязательный параметр | Для выплат на банковскую карту и банковский счет |
| Серия и номер паспорта | Серия и номер российского общегражданского паспорта. Формат: 10 цифр без пробелов. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| Дата выдачи паспорта | Дата выдачи паспорта получателя. Формат: ДД.ММ.ГГГГПередается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| Дата рождения | Дата рождения получателя. Формат: ДД.ММ.ГГГГПередается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на банковскую карту и банковский счет |
| Получатель согласен с офертой? | Подтверждение того, что получатель согласился с офертой. Возможное значение: Да | Для выплат на банковскую карту, банковский счет и номер мобильного телефона |
| Гражданство получателя | Гражданство. Возможное значение: РФ | Для выплат на банковскую карту и банковский счет |
| Город | Город получателя выплаты. Указывается адрес фактического проживания. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет |
| Улица | Улица получателя выплаты. Указывается адрес фактического проживания. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет |
| Дом | Номер дома получателя выплаты, при необходимости здесь же указывается литера и корпус. Указывается адрес фактического проживания. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет |
| Квартира | Квартира получателя выплаты (при наличии). Указывается адрес фактического проживания. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет |
| Индекс | Индекс получателя. Указывается адрес фактического проживания. Передается, если вы собираете данные самостоятельно, без использования формы ЮKassa. | Для выплат на карту иностранного банка и для выплат больше 15 000 рублей на банковскую карту и банковский счет |
| Идентификатор пользователя (не обязательно) | Идентификатор получателя выплаты в ЮKassa, полученный при сборе данных через форму. Пример: 410012345678933Необязательный параметр | Для выплат на банковскую карту и банковский счет |
Выплата до 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;card;example_payout_20190101_2;100.00;643;Ubc1CrurSqRQ5Va09IeVIRI6.SC.000.201812;;;;;;;8ХХХХХХХХХХ;;;;;;;;;;Да;;;;;;;410012345678933
Выплата на кошелек
D;4;wallet;example_payout_20190101_3;1.00;643;;41001ХХХХХХХХХХХ;;;;;;;;;;;;;;;;;;;;;;;
Выплата до 15 000 рублей на банковский счет
D;5;bank;example_payout_20190101_4;20.00;643;;;XXXXXXXXXXXXXXXXXXXX;XXXXXXXXX;"ПАО Сбербанк";Москва;XXXXXXXXXXXXXXXXXXXX;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХХХ;;;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;;;;;;
Выплата более 15 000 рублей на банковский счет
D;6;bank;example_payout_20190101_5;20.00;643;;;XXXXXXXXXXXXXXXXXXXX;XXXXXXXXX;"ПАО Сбербанк";Москва;XXXXXXXXXXXXXXXXXXXX;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХХХ;;;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;Санкт-Петербург;Ленина;"22а/1 к1";33;100291;
Выплата на банковскую карту по идентификатору получателя
D;7;card;example_payout_20190101_2;100.00;643;ХХХХХХХХХХХХХХХХ;;;;;;;8ХХХХХХХХХХ;;;;;;;;;;Да;;;;;;410012345678933
Выплата на номер мобильного телефона
D;8;tel;example_payout_20190101_6;1.00;643;;;;;;;;8ХХХХХХХХХХ;;;;;;;;;;Да;;;;;;;
Шаг 1. Добавьте заголовок — HD-строку.
Шаг 2. Добавьте информацию о выплатах — D-строки. Количество строк может быть любым. В одном файле могут быть выплаты разных видов (на кошелек, карту, счет и телефон). Порядок может быть любым, но рекомендуется группировать выплаты по видам, например, сначала перечислить в файле все выплаты на банковские карты, затем все выплаты на кошелек и так далее. Так вам будет проще ориентироваться в данных.
Шаг 3. Сохраните файл. Название файла может быть любым.
Шаг 4. Проверьте себя:
- Данные заполнены в нужном порядке.
- Данные заполнены в зависимости от вида выплат, лишние поля пустые.
- Данные указаны в нужном формате.
- Сумма выплаты соответствует лимитам.
- Получатели выплат на карты, счета или телефоны приняли оферту.
- Получатели выплат на карты и счета — граждане РФ.
- При выплате на карту иностранного банка или при выплате более 15 000 рублей на карту российского банка или банковский счет указан адрес фактического проживания получателя.
- При выплате на карту или счет указаны либо персональные данные получателя, либо его идентификатор в ЮKassa.
- Размер файла не более 2 Мбайт.
- Файл сохранен в формате CSV и кодировке UTF‑8.
Готово! Можно загружать файл в личный кабинет. Если где-то будет ошибка, ЮKassa укажет порядковый номер выплаты и расскажет, что нужно поправить. Если всё корректно, ЮKassa сформирует хеш загруженного файла по алгоритму SHA-256, отобразит хеш и общую сумму выплат. Вам останется только проверить по хешу и сумме, что загружена актуальная версия файла, и подтвердить по смс проведение выплат.
Выплаты с расчетного счетаВыплаты по спискам (XLSX)Реестры успешных и возвращенных выплатВыплаты по протоколуФорма ЮKassa для сбора данных