Запрос на получение синонима карты
Для перевода денег на банковскую карту необходимо получить синоним номера банковской карты. Это можно сделать на стороне ЮKassa или самостоятельно, по запросу.
Чтобы получить синоним самостоятельно, контрагент на своем сайте размещает форму ввода данных карты. После подтверждения ввода данные формы передаются методом POST. Сервис обрабатывает полученные данные и методом GET перенаправляет плательщика на адрес, указанный в
skr_successUrl
или
skr_errorUrl
. В случае успеха к адресу добавляются синоним, маска и дополнительные параметры карты плательщика.
 
Параметры запроса
Адрес для отправки запросов
https://paymentcard.yoomoney.ru/gates/card/storeCard
ПараметрТипОписание
skr_destinationCardNumberxs:string,
до 25 символов
Номер банковской карты.
skr_responseFormatxs:string,
до 8 символов
Формат ответа на запрос. Возможные значения:
redirect
либо
json
. Если параметр не передан — по умолчанию используется
redirect
skr_errorUrlxs:string,
до 250 символов
Адрес для перенаправления при ошибке
skr_successUrlxs:string,
до 250 символов
Адрес для перенаправления при успехе
Пример кода страницы для сохранения номера карты на стороне ЮKassa и получения ее синонима
HTML
<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_destinationCardPanmaskxs:string,
до 25 символов
Маска банковской карты
skr_destinationCardSynonimxs:string,
до 100 символов
Синоним банковской карты
reasonxs:string,
до 100 символов
Результат обработки данных:
  • success
    при успехе,
  • cardinvalid
    при неуспехе.
Дополнительные параметры
skr_destinationCardBankNamexs:string,
до 200 символов
Наименование банка, выпустившего карту
skr_destinationCardCountryCodexs:string,
до 3 символов
Цифровой код страны выпуска карты
skr_destinationCardPaymentSystemxs:string,
до 100 символов
Наименование платежной системы карты
skr_destinationCardProductNamexs:string,
до 1000 символов
Наименование карточного продукта
skr_destinationCardProductCodexs: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-формата при успешном сохранении номера карты
JSON
{"storeCard":{"skr_destinationCardSynonim":"e651e9fd23d00efa97fc713682fcc7f86faeb846_scn","skr_destinationCardPanmask":"471408*****1089"}}
Пример ответа JSON-формата при неуспешном сохранении номера карты
JSON
{"storeCard":{"reason":"cardinvalid"}}
Синоним номера карты, полученный в ответе от ЮKassa, контрагент использует в запросах на зачисление переводов. ЮKassa по полученному синониму определяют номер карты получателя.
 
Что почитать еще
Зачисление переводов на банковскую картуТипы данныхКоды ошибокТестирование