Перевод на банковскую карту

Для перевода денег на банковскую карту контрагент в параметрах запроса передает набор данных получателя: синоним банковской карты и персональные данные.

Синоним банковской карты

Получение и хранение номера банковской карты подпадает под действие стандарта PCI DSS, поэтому Яндекс.Деньги хранят данные карт на своей стороне. Чтобы контрагент мог делать выплаты на карты, Яндекс.Деньги предоставляют ему:

  • синоним карты skr_destinationCardSynonim — идентификатор карты в системе Яндекс.Денег;
  • маску карты для отображения пользователю skr_destinationCardPanmask;
  • дополнительные параметры карты, которые удалось определить в процессе обработки.

Контрагент может хранить эти данные на своей стороне без опасения утечки: их публикация не приводит к финансовым или имиджевым потерям.

Персональные данные пользователя

Персональные данные необходимо передавать в соответствии с законодательством РФ.

Обязательно — паспортные данные (ФИО, серия, номер и дата выдачи паспорта, дата рождения, гражданство) и номер телефона.

Если карта эмитирована не российским банком или если выплата больше 15 000 рублей, нужно передать дополнительные данные о месте жительства пользователя.

Note.
  • Если карта эмитирована не российским банком, то размер выплаты не влияет на количество полей: нужно всегда передавать расширенный набор данных.
  • Если прислать не все данные, в ответ на запрос на перевод денег (makeDeposition) вернется ошибка (error=48).

Сценарии проведения выплат на карту

Собирать данные можно самостоятельно или с помощью формы Яндекс.Денег.

Самостоятельное получение синонима банковской карты и персональных данных пользователя

Контрагенту необходимо:

  1. разместить на своем сайте форму для ввода персональных данных пользователя и собрать данные;
  2. отправить запрос на перевод денег (makeDeposition) и передать в нём полученный синоним, персональные данные пользователя и подтверждение принятия оферты.

Яндекс.Деньги будут проверять персональные данные каждый раз, когда контрагент будет отправлять запрос makeDeposition.

Получение синонима и сбор персональных данных на стороне Яндекс.Денег

Контрагенту необходимо:

  1. перенаправить пользователя на форму Яндекс.Денег для сбора данных банковской карты и персональных данных и получить синоним карты и идентификатор пользователя;
  2. отправить запрос на перевод денег (makeDeposition) и передать в нём данные, полученные на шаге 1 и подтверждение принятия оферты.

Яндекс.Деньги будут проверять персональные данные только при их сборе.

Запрос на перевод денег на банковскую карту

Идентификатор получателя (dstAccount)
Тип счета получателя dstAccount
Банковская карта 25700130535186
Тип счета получателя dstAccount
Банковская карта 25700130535186
Параметры запроса
Имя поля paymentParams Тип Описание
skr_destinationCardSynonim xs:string, до 50 символов

Синоним номера банковской карты.

Обязательный параметр

pof_offerAccepted xs:int, 1 символ

Подтверждение принятия оферты пользователем (1 — принята).

Обязательный параметр

Данные пользователя — обязательно при сборе данных с помощью формы Яндекс.Денег
cps_ymAccount xs:string, до 25 символов Идентификатор пользователя в Яндекс.Деньгах. Равен значению параметра accountNumber, полученного в ответе после идентификации пользователя через форму
Персональные данные получателя платежа — обязательно при самостоятельном сборе данных
pdr_lastName xs:string, до 50 кириллических символов

Фамилия

pdr_firstName xs:string, до 50 кириллических символов Имя
pdr_middleName xs:string, до 50 кириллических символов Отчество. Обязательно, если есть в паспорте
pdr_docNumber xs:long, 10 символов Серия и номер паспорта гражданина РФ (без пробелов)
pdr_docIssueDate xs:string, 10 символов Дата выдачи паспорта в формате ДД.ММ.ГГГГ
smsPhoneNumber xs:long, до 15 символов Номер телефона получателя платежа в международном формате (79...)
pdr_birthDate xs:string, 10 символов Дата рождения в формате ДД.ММ.ГГГГ
pdr_country xs:int, 3 цифры Гражданство. Указывается как цифровой код страны (РФ — 643)
Дополнительные персональные данные (если выплата больше 15 000 рублей или если карта эмитирована не российским банком) — обязательно при самостоятельном сборе данных
pdr_city xs:string, до 30 кириллических символов Город получателя платежа
pdr_address xs:string, до 100 кириллических символов Адрес получателя платежа
pdr_postcode xs:long, 6 символов Почтовый индекс
Имя поля paymentParams Тип Описание
skr_destinationCardSynonim xs:string, до 50 символов

Синоним номера банковской карты.

Обязательный параметр

pof_offerAccepted xs:int, 1 символ

Подтверждение принятия оферты пользователем (1 — принята).

Обязательный параметр

Данные пользователя — обязательно при сборе данных с помощью формы Яндекс.Денег
cps_ymAccount xs:string, до 25 символов Идентификатор пользователя в Яндекс.Деньгах. Равен значению параметра accountNumber, полученного в ответе после идентификации пользователя через форму
Персональные данные получателя платежа — обязательно при самостоятельном сборе данных
pdr_lastName xs:string, до 50 кириллических символов

Фамилия

pdr_firstName xs:string, до 50 кириллических символов Имя
pdr_middleName xs:string, до 50 кириллических символов Отчество. Обязательно, если есть в паспорте
pdr_docNumber xs:long, 10 символов Серия и номер паспорта гражданина РФ (без пробелов)
pdr_docIssueDate xs:string, 10 символов Дата выдачи паспорта в формате ДД.ММ.ГГГГ
smsPhoneNumber xs:long, до 15 символов Номер телефона получателя платежа в международном формате (79...)
pdr_birthDate xs:string, 10 символов Дата рождения в формате ДД.ММ.ГГГГ
pdr_country xs:int, 3 цифры Гражданство. Указывается как цифровой код страны (РФ — 643)
Дополнительные персональные данные (если выплата больше 15 000 рублей или если карта эмитирована не российским банком) — обязательно при самостоятельном сборе данных
pdr_city xs:string, до 30 кириллических символов Город получателя платежа
pdr_address xs:string, до 100 кириллических символов Адрес получателя платежа
pdr_postcode xs:long, 6 символов Почтовый индекс
Пример запроса для зачисления средств на банковскую карту (сокращенный набор полей)
<makeDepositionRequest
  requestDT="2019-06-21T14:13:37.965Z"
  contract="Перевод денег на банковскую карту"
  amount="15000.00"
  agentId="12345"
  clientOrderId="payouts-110_1561126417933"
  dstAccount="25700595304842"
  currency="643">
  <paymentParams>
    <skr_destinationCardSynonim>oALesdd_h_YT6pzpJ10Kn5aB.SC.000.201906</skr_destinationCardSynonim>
    <pof_offerAccepted>1</pof_offerAccepted>
    <smsPhoneNumber>79818932328</smsPhoneNumber>
    <pdr_firstName>Эдуард</pdr_firstName>
    <pdr_lastName>Запеканкин</pdr_lastName>
    <pdr_docNumber>1013123456</pdr_docNumber>
    <pdr_docIssueDate>10.10.2013</pdr_docIssueDate>
    <pdr_country>643</pdr_country>
    <pdr_birthDate>1973-10-31</pdr_birthDate>
  </paymentParams>
</makeDepositionRequest>
Пример запроса для зачисления средств на банковскую карту (полный набор полей)
<makeDepositionRequest
  requestDT="2019-06-21T14:17:29.578Z"
  contract="Перевод денег на банковскую карту"
  amount="20000.00"
  agentId="12345"
  clientOrderId="payouts-110_1561126649528"
  dstAccount="25700595305003"
  currency="643">
  <paymentParams>
    <skr_destinationCardSynonim>3lSdWL0Yf9DHRd2r4LAbyhfV.SC.000.201906</skr_destinationCardSynonim>
    <pof_offerAccepted>1</pof_offerAccepted>
    <smsPhoneNumber>79818932328</smsPhoneNumber>
    <pdr_firstName>Эдуард</pdr_firstName>
    <pdr_lastName>Запеканкин</pdr_lastName>
    <pdr_docIssueDate>10.10.2013</pdr_docIssueDate>
    <pdr_phoneNumber>79111471111</pdr_phoneNumber>
    <pdr_postcode>701152</pdr_postcode>
    <pdr_country>643</pdr_country>
    <pdr_city>Санкт-Петербург</pdr_city>
    <pdr_address>Невский проспект, д 1, к 2, кв 1</pdr_address>
    <pdr_birthDate>1967-07-22</pdr_birthDate>
  </paymentParams>
</makeDepositionRequest>
Пример запроса для зачисления средств на банковскую карту (сбор данных на стороне Яндекс.Денег)
<makeDepositionRequest
  agentId="200200"
  clientOrderId="db6c3eaf9ffc0d8933490ed1"
  requestDT="2018-12-01T00:00:01+03:00"
  dstAccount="25700130535186"
  amount="100.00"
  currency="643"
  contract="Перевод денег на банковскую карту">
  <paymentParams>
    <skr_destinationCardSynonim>2OHSXN6QG-vGPX8WHtOciU86.SC.000.201906</skr_destinationCardSynonim>
    <pof_offerAccepted>1</pof_offerAccepted>
    <cps_ymAccount>4100322815079</cps_ymAccount>
  </paymentParams>
</makeDepositionRequest>
Note.

Если при переводе на банковскую карту возникла ошибка (error=48), ответ Яндекс.Денег может содержать дополнительный поясняющий текст (techMessage):

  • notRegistrationRecord — не хватает обязательных параметров (pdr_). Дополнительно указывается перечень недостающих полей.
  • Банк отклонил перевод денег на данную карту.
  • Банк отклонил операцию.
  • Превышен лимит операций.
  • Паспортные данные не прошли проверку.

Пример сообщения об ошибке

<makeDepositionResponse
  clientOrderId="payouts-110_1561103462999"
  status="3"
  error="48"
  processedDT="2019-06-21T10:51:04.089+03:00"
  techMessage="Не заданы или неверно заданы поля: pdr_docIssueDate"
/>

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

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

Типы данных

Коды ошибок

Тестирование