Инструменты страницы

Запрос проверки вовлечённости карты в 3-D Secure (verifyEnrollment.do)

Для проверки вовлечённости карты в 3-D Secure используется запрос verifyEnrollment.do.

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

  • A<n> – последовательность латинских букв длины <n>;
  • A..<n> – последовательность латинских букв длиной, не превышающей <n>;
  • N<n> – последовательность цифр длины <n>;
  • N..<n> – последовательность цифр длиной, не превышающей <n>;
  • AN<n> – последовательность латинских букв и цифр фиксированной длины <n>;
  • AN..<n> – последовательность латинских букв и цифр длиной, не превышающей <n>;
  • ANS<n> – последовательность латинских букв, цифр и символов фиксированной длины <n>
  • ANS..<n> – последовательность латинских букв, цифр и символов длиной, не превышающей <n>;
  • UTC – дата и время, при этом: дата должна быть передана без указания часового пояса, время московское, для протокола SOAP используется стандартная кодировка xs:dateTime.

Пользуясь протоколом REST, тело сообщения запроса следует отправлять с типом: 'Content-Type: application/x-www-form-urlencoded'.

Параметры запроса

Параметры запроса представлены в таблице ниже.

Название Тип Обязательно Описание

userName

AN..30

Да

Логин служебной учётной записи продавца.

password

AN..200

Да

Пароль служебной учётной записи продавца.

pan

N12…19

Да

Маскированный номер карты, которая использовалась для оплаты. Указан только после оплаты заказа.

В случае оплаты через Apple Pay в качестве номера карты используется DPAN: номер, привязанный к мобильному устройству покупателя и выполняющий функции номера платёжной карты в системе Apple Pay.

Параметры ответа

Параметры ответа представлены в таблице ниже.

Название Тип Обязательно Описание

errorCode

N..2

Нет

Код ошибки. Может отсутствовать, если результат не привёл к ошибке.

errorMessage

AN..512

Нет

Описание ошибки на языке, переданном в параметре language в запросе.

isEnrolled

A1

Нет

Признак вовлечённости карты в 3-D Secure. Возможные значения:

  • Y - да;
  • N - нет;
  • U - неизвестно.

emitterName

AN..160

Нет

Наименование банка-эмитента.

emitterCountryCode

AN..4

Нет

Код страны банка-эмитента.

Коды ошибок

Код ошибки Текст ошибки
0

Обработка запроса прошла без системных ошибок.

1

Не указан номер карты.

1

Номер карты должен быть числом, содержащим от 13 до 19 цифр.

5

Пользователь должен сменить свой пароль.

5

Доступ запрещён.

6

По заданному номеру карты информация не найдена.

7

Системная ошибка.

Примеры

Пример запроса POST

pan=4111111111111111

Пример ответа

{"errorCode":"0","errorMessage":"Успешно","emitterName":"TEST CARD","emitterCountryCode":"RU","enrolled":"Y"}