API ЮKassa
Помощь
Подключить ЮKassa
Список в формате CSV
Вы можете делать выплаты через личный кабинет с помощью файлов формата XLSX и CSV. Если вы хотите заполнять данные вручную, рекомендуется использовать файл в формате XLSX. Если вы ведете учет получателей выплат в специальной программе, например в CRM, можно выгрузить данные прямо оттуда в файл CSV и загрузить его в личный кабинет.
Из этой статьи вы узнаете, как правильно заполнить файл CSV:
Требования к формату
Формат файла реестра соответствует рекомендации IETF RFC4180. Разделитель полей — точка с запятой «;». Кодировка символов — UTF‑8.
Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"», точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"».
Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.
Структура файла
Содержимое файла реестра состоит из следующих элементов:
  • HD-строка — заголовок реестра;
  • D-строки — данные о выплатах.
Заголовок (HD-строка)
Заголовок реестра всегда должен быть следующим:
HD;№;Тип;"Уникальный номер выплаты";Сумма;Валюта;"Номер банковской карты (или синоним)";"Номер кошелька";"Расчётный счёт";БИК;Наименование;"Город отделения";"Корр. счёт";Телефон;Фамилия;Имя;Отчество;"ИНН получателя(не обязательно)";"ОМС получателя(не обязательно)";"СНИЛС получателя(не обязательно)";"Серия и номер паспорта";"Дата выдачи паспорта";"Дата рождения";"Получатель согласен с офертой?";"Гражданство получателя";Город;Улица;Дом;Квартира;Индекс;"Идентификатор пользователя(не обязательно)"
Данные для выплат (D-строка)
Для каждой выплаты нужно сформировать отдельную D-строку. Общее количество полей всегда неизменно, количество заполненных полей зависит от вида выплаты.
Описание полей
ПолеОписаниеОбязательность заполнения
Тип строкиТип строки в CSV-файле. Возможное значение: D — строка выплатДля всех видов выплат
Номер выплаты в спискеНомер выплаты в вашем списке. Этот номер ЮKassa будет использовать в сообщениях об ошибках при загрузке файлаДля всех видов выплат
Тип
Вид выплаты в ЮKassa. Возможные значения:
  • card — выплата на банковскую карту;
  • wallet — выплата на кошелек ЮMoney;
  • bank — выплата на банковский счет;
  • tel — выплата на номер мобильного телефона
Для всех видов выплат
Уникальный номер выплатыИдентификатор, уникальный для всех ваших выплат. Отображается в истории выплат в личном кабинетеДля всех видов выплат
СуммаСумма выплаты. Минимальное и максимальное значение зависит от вида выплаты. Формат: десятичное число с двумя знаками после запятой, разделитель — точка или запятаяДля всех видов выплат
ВалютаВалюта выплаты. Возможное значение: 643 — российский рубльДля всех видов выплат
Номер банковской карты (или синоним)Номер банковской карты, на которую нужно сделать выплату, или ее синоним, полученный с помощью формы ЮKassa. Формат номера карты: 16 или 18 цифр без пробеловДля выплат на банковскую карту
Номер кошелькаНомер кошелька, на который нужно сделать выплату. Формат: от 12 до 16 цифр без пробелов, номер начинается с 41001Для выплат на кошелек ЮMoney
Расчётный счётНомер расчетного счета, на который нужно сделать выплату. Формат: 20 цифр без пробеловДля выплат на банковский счет
БИКБИК банка. Формат: 9 цифр без пробеловДля выплат на банковский счет
НаименованиеНаименование банка.Для выплат на банковский счет
Город отделенияГород, в котором находится отделение банка.Для выплат на банковский счет
Корр. счётКорреспондентский счет отделения банка. Формат: 20 цифр без пробеловДля выплат на банковский счет
Телефон
Номер телефона получателя выплаты. Формат: номер начинается с 8, количество цифр зависит от вида выплат:
  • выплаты на телефон — максимум 11 цифр;
  • выплаты на карту или банковский счет — максимум 15 цифр
Для выплат на банковскую карту, банковский счет и номер мобильного телефона
Фамилия
Фамилия получателя (строго как в паспорте).
Передается, если вы собираете данные самостоятельно, без использования формы Ю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 для сбора данных