Page Comparison

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

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

XML-запрос

XML-запрос имеет следующий формат

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Request>
  <Operation>Process3DSAuth</Operation>
  <Step>FIRST</Step>
  <Order>
   <OrderID>818</OrderID>
   <Merchant>TEST_TRADER_2</Merchant>
  </Order>
  <SessionID>DFSDF$</SessionID>
  <PAN>7654310438720050</PAN>
  <PAN2>7654390437724050</PAN2>
  <ExpDate>1909</ExpDate>
  <CVV2>123</CVV2>
 </Request>
</TKKPG>

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

Table of Contents

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

Параметр	Нужность	Описание
Operation	Да	Тип операции. Фиксированное значение: Process3DSAuth
Step	Да	Этап проверки. Фиксированное значение: FIRST
OrderID	Да	Идентификатор заказа, по которому необходимо выполнить операцию
Merchant	Да	Идентификатор интернет-магазина.
SessionID	Да	Идентификатор сессии заказа
PAN	Да	Номер карты
PAN2	Нет	Номер карты получателя. Обязателен при выполнении операции P2PTransfer
ExpDate	Да	Срок действия карты в формате YYMM.
CVV2	Да	CVV2 карты. Если CVV2 не вводился, необходимо преедать значение '-1' (минус один)

XML-ответ для версии 2.1

XML-ответ имеет следующий формат

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Response>
  <Operation>Process3DSAuth</Operation>
  <Status>00</Status>
  <NextStep>AREQ</NextStep>
  <Refinement>
   <RefinementType></RefinementType>
   <MethodUrl> </MethodUrl>
   <ThreeDSMethodNotificationURL></ThreeDSMethodNotificationURL>
   <ThreeDSServerTransId></ThreeDSServerTransId>
  </Refinement>
 </Response>
</TKKPG>

Описание параметров XML-ответа для версии 3DS 2.1

Параметр	Описание
Status	Результат выполнения запроса: 00 – успешно 30 – неверный формат сообщения (нет обязательных параметров и т. д.) 10 – интернет-магазин не имеет доступа к операции создания заказа (или такой интернет-магазин не зарегистрирован) 54 – недопустимая операция 72 – системная ошибка 96 – системная ошибка 97 – системная ошибка
NextStep	Определяет следующий шаг проверки. Фиксированное значение: AREQ
Operation	Тип выполненной операции
Refinement	Опциональный блок в ответе, если предоставлены данные от DS. В случае, когда блок присутствует, необходимо инициировать открытие скрытого фрейма в браузере клиента, с помощью которого данные о браузере передаются по протоколу HTTP на URL адрес ACS, полученный в ответе в параметре MethodUrl. После завершения взаимодействия с браузером клиента ACS отправляет соответствующее уведомление в по протоколу HTTP на адрес, указанный в параметре ThreeDSMethodNotificationURL.

XML-ответ для версии 1.0

XML-ответ имеет следующий формат

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Response>
  <Operation>Process3DSAuth</Operation>
  <NextStep>PARES</NextStep>
  <Refinement>
    <RefinementType>PAREQ</RefinementType>
    <AcsURL>https://acs-test.procard.com.ua/PaReqMC.jsp</AcsURL>
    <PAReq>eJxVU[... skip ...]fr16</PAReq>
  </Refinement>
  <Status>00</Status>
 </Response>
</TKKPG>

Описание параметров XML-ответа для версии 3DS 1.0

Параметр	Описание
Status	Результат выполнения запроса: 00 – успешно 30 – неверный формат сообщения (нет обязательных параметров и т. д.) 10 – интернет-магазин не имеет доступа к операции создания заказа (или такой интернет-магазин не зарегистрирован) 54 – недопустимая операция 72 – системная ошибка 96 – системная ошибка 97 – системная ошибка
NextStep	Определяет следующий шаг проверки. Фиксированное значение: PARES
Refinement.RefinementType	Тип данных, которые необходимо передать на следующем этапе: Фиксированное значение: PAREQ
Refinement.AcsURL	URL-адрес сервера ACS
Refinement.PAReq	Сообщение PAReq, в POST-сообщении которое необходимо сформировать в браузере покупателя при перенаправлении на ACS эмитента карты.

Описание параметров XML-ответа для версии non-3DS - финансовая транзакция

XML-ответ имеет следующий формат

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Response>
  <Operation>Process3DSAuth</Operation>
  <Status>00</Status>
  <Result>
   <XMLOut>(Описание полей см. ниже)</XMLOut>
  </Result>
  <ARes>{ "threeDSServerTransID" : "97018b26-1feb-4f5f-8b5e-8b75f5d6ec20", "acsTransID" : "cd7acc4e-490b-4e75-8467-df892ea47c5f", "dsTransID" : "8be2f05a-5a31-4cd6-aa0b-1673ccb1fa01", "messageType" : "ARes", "messageVersion" : "2.1.0", "acsReferenceNumber" : "3DS_LOA_ACS_PPFU_020100_00013", "acsOperatorID" : "acsOperatorUL", "authenticationValue" : "AJkBARckOAAAAAAAYyQ4AAAAAAA=", "eci" : "05", "dsReferenceNumber" : "LOCAL_DS_123", "transStatus" : "Y", "transStatusReason" : "17" }</ARes>
 </Response>
</TKKPG>

< Описание полей >

Filter by label (Content by label)

showLabels	false
spaces	API
showSpace	false
sort	title
type	page
title	Связанные страницы:
cql	label = "поставщики-услуг" and type = "page" and parent = "1195737122"
labels	documentation-space-sample

Versions Compared

Old Version 15

New Version Current

Key

XML-запрос

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

XML-ответ для версии 2.1

Описание параметров XML-ответа для версии 3DS 2.1

XML-ответ для версии 1.0

Описание параметров XML-ответа для версии 3DS 1.0

Описание параметров XML-ответа для версии non-3DS - финансовая транзакция