Запрос на проведение 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.