Инструменты страницы
Запрос на проведение 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.
Параметры запроса:
Название | Тип | Обязательно | Описание |
---|---|---|---|
|
ANS..36 | Да |
Идентификатор транзакции, полученный от сервера 3DS. |
Параметры ответа:
Название | Тип | Обязательно | Описание |
---|---|---|---|
|
ANS..* | Да | Адрес перенаправления в случае успешной обработки запроса. |
|
N..2 | Нет |
Код ошибки. |
|
|
Нет | Описание ошибки. |
Если 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
.