Протокол массовых выплат устарел. Если хотите делать выплаты по API, используйте API ЮKassa.
Для перевода денег на банковскую карту необходимо собрать персональные данные пользователя и данные банковской карты. Это можно сделать самостоятельно или с помощью специальной формы ЮKassa.
Если использовать форму, ЮKassa будет хранить необходимые данные на своей стороне. Вы получите синоним банковской карты и идентификатор пользователя в ЮKassa — это обезличенные данные, публикация которых не несет имиджевых или финансовых рисков. С помощью полученных данных вы сможете проводить выплаты на карту без проверки паспортных данных.
ЮKassa будет проверять персональные данные только при получении идентификатора пользователя. Срок действия идентификатора один год. Для дальнейших выплат на карту пользователя персональные данные нужно собирать заново.
Шаг 1. Пользователь в вашей системе инициирует выплату на свою банковскую карту.
Шаг 2. Вы перенаправляете пользователя на форму для сбора данных банковской карты.
Шаг 3. Пользователь вводит данные карты и нажимает Дальше.
Форма ввода данных банковской карты
Шаг 4. Переходит на форму для ввода паспортных данных, заполняет все поля и нажимает На проверку.
Форма ввода персональных данных пользователя (полный набор полей)
Шаг 5. ЮKassa отображает пользователю ИНН, соответствующий этим данным, и просит пользователя подтвердить, что ИНН принадлежит ему.
Форма подтверждения ИНН
Когда пользователь нажимает Подтверждаю, ЮKassa отправляет вам параметры для проведения выплаты (синоним банковской карты и идентификатор пользователя) и перенаправляет пользователя на страницу успеха.
Если с данными что-то не так или по ним не получилось найти ИНН, ЮKassa просит пользователя еще раз проверить введенные данные и поправить их при необходимости.
Форма проверки введенных данных
Если пользователь что-то меняет в своих данных, ЮKassa заново запускает проверку. Если пользователь ничего не меняет и подтверждает, что данные корректны, ЮKassa предлагает пользователю ввести данные второго документа — ИНН, СНИЛС или полиса ОМС, чтобы проверить получателя выплат другим способом.
Форма ввода вторго документа
Если после этого проверка проходит успешно, ЮKassa отправляет вам параметры для проведения выплаты (синоним банковской карты и идентификатор пользователя) и перенаправляет пользователя на страницу успеха. Если с данными всё еще что-то не так, ЮKassa перенаправляет пользователя на страницу неудачи.
Шаг 6. ЮKassa отправляет полученные данные в сервис ГУВМ МВД для завершения проверки получателя выплат.
Готово!
Выплаты можно делать сразу, как только вы получите данные от ЮKassa. Окончательный результат проверки вы узнаете при первом использовании идентификатора пользователя:
- Если выплата с этим идентификатором пользователя, пройдет успешно (status=0), то всё хорошо, получатель идентифицирован, данные можно использовать для проведения выплат.
- Если в ответ вернется ошибка, что паспортные данные не прошли проверку (status=3иerror=48), то получателю выплаты необходимо еще раз пройти идентификацию.
- Если в ответ вернется сообщение, что запрос в обработке (status=1), то это значит, что проверка данных еще идет. Дождитесь финального статуса запроса (успех или неудача).
Форма для сбора данных размещена на стороне ЮKassa. Вам нужно перенаправить на нее пользователя.
Адрес для отправки запросов
https://yookassa.ru/cardauth
| Параметр | Тип | Описание |
|---|---|---|
| url_success | xs:string, до 250 символов | URL, на который необходимо отправить пользователя в случае успеха авторизации. Обязательный параметр |
| url_error | xs:string, до 250 символов | URL, на который необходимо отправить пользователя в случае неуспеха авторизации. Обязательный параметр |
| identify | xs:boolean | Необходимость получить от пользователя данные для идентификации кошелька. Используется в случае, если требуется хранение и проверка паспортных данных на стороне ЮKassa. Необязательный параметр Если передан, в ответе придет результат проверки паспортных данных ( identificationStatus ) и идентификатор пользователя в ЮKassa (accountNumber ). |
| small_amount_only | xs:boolean | Признак выплат от 100 до 15 000 рублей включительно. Влияет на количество полей, которые нужно заполнить пользователю. Значение по умолчанию — false .Необязательный параметр |
- Если выплаты будут небольшие (до 15 000 рублей), рекомендуется передать small_amount_only=true. В этом случае, если карта эмитирована российским банком, пользователю нужно будет заполнить меньше полей.
- Чтобы после привязки банковской карты пользователь ввел свои персональные данные, необходимо передать identify=true.
Пример формы (полный набор полей)
https://yookassa.ru/cardauth?url_error=http://domain.tld/fail&url_success=http://domain.tld/success&identify=true
Пример формы (сокращенный набор полей)
https://yookassa.ru/cardauth?url_error=http://domain.tld/fail&url_success=http://domain.tld/success&identify=true&small_amount_only=true
ЮKassa обрабатывает полученные на форме данные и перенаправляет пользователя методом GET на адрес, указанный в
url_success
или url_error
.Вы получаете ответ при перенаправлении пользователя на страницу успеха или ошибки.
В случае успеха к адресу добавляются синоним, маска и дополнительные параметры карты пользователя, которые удалось определить в процессе обработки. Вы можете хранить синонимы, маски и дополнительные параметры карты на своей стороне без опасения утечки: их публикация не приводит к финансовым или имиджевым потерям.
| Параметр | Тип | Описание |
|---|---|---|
| Обязательные параметры | ||
| skr_destinationCardPanmask | xs:string, до 25 символов | Маска банковской карты. Пример: 510612******3456 |
| skr_destinationCardSynonim | xs:string, до 100 символов | Синоним банковской карты. Пример: Ubc1CrurSqRQ5Va09IeVIRI6.SC.000.201812 |
| skr_destinationCardCountryCode | xs:string, до 3 символов | Цифровой код страны, в которой выпущена карта. Например, 643 (Россия) |
| skr_destinationCardType | xs:string, до 25 символов | Тип банковской карты. Visa , Mastercard , Mir |
| identificationStatus | xs:string, до 100 символов | Результат проверки паспортных данных:
Возвращается, только если вы передали в форме identify=true |
| accountNumber | xs:string, до 25 символов | Идентификатор пользователя в ЮKassa. Возвращается только в случае успеха идентификации. Пример: 410012345678933 Возвращается, только если вы передали в форме identify=true |
| Условно-обязательные параметры | ||
| identificationError | xs:string, до 1000 символов | Возвращается только в случае ошибки при проверке. В отдельных случаях может не возвращаться |
Ответ ЮKassa может включать не описанные в этом документе параметры. Вам следует их игнорировать.
Полученные данные нужно использовать в запросах на зачисление переводов. ЮKassa по полученному синониму определяют номер карты получателя, а по идентификатору — персональные данные пользователя.
Зачисление переводов на банковскую картуТипы данныхКоды ошибокТестирование