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

ACS эмитента проводит аутентификацию держателя карты и перенаправляет клиента в обратно в магазин. Магазин передаёт в платёжный шлюз идентификатор транзакции с помощью метода finishThreeDsVer2.

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

  • 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.

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

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

threeDSServerTransId

ANS..36

Да

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

Параметр используется при проведения аутентификации клиента по протоколу 3DS версии 2.0.

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

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

redirect

ANS..*

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

errorCode

N..2

Нет

Код ошибки.

errorMessage

AN..512

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

Если errorCode=0 и info=«Your order is proceeded, redirecting» – оплата прошла успешно. В других случаях с ошибкой, см. сообщение об ошибке errorMessage.

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

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

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mer="http://engine.paymentgate.ru/webservices/merchant">
    <soapenv:Header/>
    <soapenv:Body>
       <mer:finishThreeDsVer2>
          <request language="ru" threeDSServerTransId="8b5b7ee5-eb5a-4cf4-81ec-7153f7ca2864"/>
       </mer:finishThreeDsVer2>
    </soapenv:Body>
 </soapenv:Envelope>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
       <ns1:finishThreeDsResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
          <return errorCode="0" redirect="http://ya.ru?orderId=8b5b7ee5-eb5a-4cf4-81ec-7153f7ca2864"/>
       </ns1:finishThreeDsResponse>
    </soap:Body>
 </soap:Envelope>