Для перевода денег на банковскую карту необходимо получить синоним номера банковской карты. Это можно сделать на стороне ЮKassa или самостоятельно, по запросу.
Чтобы получить синоним самостоятельно, вы на своем сайте размещаете форму ввода данных карты. После подтверждения ввода данные формы передаются методом POST. ЮKassa обрабатывает полученные данные и методом GET перенаправляет пользователя на адрес, указанный в
skr_successUrl или skr_errorUrl. В случае успеха к адресу добавляются синоним, маска и дополнительные параметры карты пользователя.Адрес для отправки запросов
https://paymentcard.yoomoney.ru/gates/card/storeCard
| Параметр | Тип | Описание |
|---|---|---|
| skr_destinationCardNumber | xs:string, до 25 символов | Номер банковской карты. |
| skr_responseFormat | xs:string, до 8 символов | Формат ответа на запрос. Возможные значения: redirect либо json. Если параметр не передан — по умолчанию используется redirect |
| skr_errorUrl | xs:string, до 250 символов | Адрес для перенаправления при ошибке |
| skr_successUrl | xs:string, до 250 символов | Адрес для перенаправления при успехе |
Пример кода страницы для сохранения номера карты на стороне ЮKassa и получения ее синонима
<html> <body> <form action=https://paymentcard.yoomoney.ru/gates/card/storeCard method=post> <input type=text name=skr_destinationCardNumber/> <br/> <input type=hidden name=skr_responseFormat value=redirect/> <br/> <input type=text name="skr_errorUrl" value="http://example.com/error"/> <br/> <input type=text name="skr_successUrl" value="http://example.com/success"/> <br/> <input type=submit value="Сохранить"/> </body> </html>
| Параметр | Тип | Описание |
|---|---|---|
| Обязательные параметры | ||
| skr_destinationCardPanmask | xs:string, до 25 символов | Маска банковской карты |
| skr_destinationCardSynonim | xs:string, до 100 символов | Синоним банковской карты |
| reason | xs:string, до 100 символов | Результат обработки данных:
|
| Дополнительные параметры | ||
| skr_destinationCardBankName | xs:string, до 200 символов | Наименование банка, выпустившего карту |
| skr_destinationCardCountryCode | xs:string, до 3 символов | Цифровой код страны выпуска карты |
| skr_destinationCardPaymentSystem | xs:string, до 100 символов | Наименование платежной системы карты |
| skr_destinationCardProductName | xs:string, до 1000 символов | Наименование карточного продукта |
| skr_destinationCardProductCode | xs:string, до 20 символов | Код карточного продукта |
Пример ответа redirect формата
[skr_successUrl]/?skr_destinationCardProductCode=P&skr_destinationCardProductName=Visa+Gold&skr_destinationCardSynonim=4878b27eaec2022c5a6a4e82d971a6271bf6fcd8_scn&skr_destinationCardType=Visa&skr_destinationCardCountryCode=616&skr_destinationCardBankName=Norwegian+Visa-Bankgroup&skr_destinationCardPanmask=444444******4448
Пример ответа JSON-формата при успешном сохранении номера карты
{"storeCard":{"skr_destinationCardSynonim":"e651e9fd23d00efa97fc713682fcc7f86faeb846_scn","skr_destinationCardPanmask":"471408*****1089"}}
Пример ответа JSON-формата при неуспешном сохранении номера карты
{"storeCard":{"reason":"cardinvalid"}}
Синоним номера карты, полученный в ответе от ЮKassa, вам нужно использовать в запросах на зачисление переводов. ЮKassa по полученному синониму определяет номер карты получателя.
Зачисление переводов на банковскую картуТипы данныхКоды ошибокТестирование