8. Административная операция GetPAReqForm [SP]

На этой странице описана административная операция GetPAReqForm на платежном портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG

Структура административной операции GetPAReqForm продукта PC-ECOM-PG представляется в виде XML-запроса отсылаемого на платежный портал ПЦ "Прокард" с варьируемыми параметрами, на который приходит XML-ответ также с варьируемыми параметрами.

Содержание XML-запроса и XML-ответа описываются следующим образом:

На этой странице:

  • XML-запрос
XML-запрос имеет формат
<?xml version=”1.0” encoding=”UTF-8”?>
<TKKPG>
   <Request>
      <Operation>GetPAReqForm</Operation>
      <Order>
         <Merchant></Merchant>
         <OrderID></OrderID>
      </Order>
      <SessionID></SessionID>
      <PAN></PAN>
      <ExpDate></ExpDate>
      <Amount></Amount>
      <Currency></Currency>
      <exponent></exponent>
      <EncodedPAReq></EncodedPAReq>
      <Fee></Fee>
   </Request>
</TKKPG>
  • Описание параметров запроса
ПараметрНужностьОписание

Merchant

Да

Идентификатор интернет-магазина.

OrderID

Да

Идентификатор заказа, по которому необходимо
подготовить данные

SessionID

Да

Идентификатор сессии заказа

PAN

Нет

Номер карты

ExpDate

Условно

Срок действия карты в формате YYMM.

Amount

Нет

Сумма операции. По умолчанию используется сумма заказа

Currency

Нет

Валюта операции. По умолчанию используется валюта заказа

exponent

Нет

Количество знаков после запятой (экспонента). Если параметр не задан, то в PAReq передается значение экспоненты – 2

EncodedPAReq

Нет

Шифрование сообщения PAReq. Возможные значения: true – в ответе на операцию сообщение PAReq будет закодировано false – в ответе на операцию сообщение PAReq будет в чистом виде

Fee

Нет

Сумма комиссии в минимальных единицах валюты. Копейки, центы

  • Пример Ответа
XML-ответ имеет следующий формат
<?xml version=”1.0” encoding=”UTF-8”?>
<TKKPG>
   <Response>
      <Operation>GetPAReqForm</Operation>
      <Status>00</Status>
      <url></url>
      <MD></MD>
      <termURL></termURL>
      <pareq></pareq>
   </Response>
</TKKPG>
  • Описание параметров ответа
ПараметрНужностьОписание

Status

Да

Результат выполнения запроса:
00 – успешно
30 – неверный формат сообщения (нет обязательных параметров и т. д.)
10 – интернет-магазин не имеет доступа к операции проверки участия карты в 3-D Secure (или такой интернет-магазин не зарегистрирован)
54 – недопустимая операция

72 – системная ошибка
96 – системная ошибка
97 – системная ошибка

url

Да

URL-адрес сервера ACS.

MD

Да

Merchant Data. TWEC PG всегда возвращает данный параметр пустым, поэтому параметр должен заполняться ТСП. Параметр необходим для связки отправляемого PAReq с возвращаемым PARes. Например, в данном параметре можно указать OrderID и SessionID в кодировке base64.

termUrl

Да

URL-адрес ТСП, которому должен быть отправлен результат операции. TWEC PG всегда возвращает данный параметр пустым, поэтому параметр должен заполняться ТСП

pareq

Да

Сообщение PAReq