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

Запрос на проведение 3DS-платежа (REST)

Для завершения операции магазин отправляет в шлюз идентификатор транзакции при помощи метода finish3dsVer2.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.

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

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

tDsTransId

ANS..36

Да

Идентификатор транзакции, полученный от сервера 3DS.

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

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

redirect

ANS..*

Да Адрес перенаправления в случае успешной обработки запроса.

errorCode

N..2

Нет

Код ошибки.

errorMessage

AN..512

Нет Описание ошибки.

Если errorCode = 0 - оплата прошла успешно. В других случаях с ошибкой, см. сообщение об ошибке error.

Коды ошибок (поле errorCode):

Значение Описание
0 Обработка запроса прошла без системных ошибок
5 Доступ запрещён
5 Пользователь должен сменить свой пароль
7 Заказ не найден
7 Системная ошибка

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

tDsTransId=f44d6d21-1874-45a5-aeb0-1c710dd6e134&userName=login&password=password

Пример ответа на запрос

{"redirect":"http://ya.ru?orderId=906bf262-bd53-4ac7-983c-07127954681b","errorCode":0}

Для того, чтобы в ответ пришел json, а не редирект, надо вызвать метод finish3dsVer2Payment.do методом POST с параметром threeDSServerTransId.