API ЮKassa
Помощь
Подключить ЮKassa
Запрос на получение синонима карты
Для перевода денег на банковскую карту необходимо получить синоним номера банковской карты. Это можно сделать на стороне ЮKassa или самостоятельно, по запросу.
Чтобы получить синоним самостоятельно, вы на своем сайте размещаете форму ввода данных карты. После подтверждения ввода данные формы передаются методом POST. ЮKassa обрабатывает полученные данные и методом 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 по полученному синониму определяет номер карты получателя.
Что почитать еще
Зачисление переводов на банковскую картуТипы данныхКоды ошибокТестирование