4.2. Process3DSAuth - FIRST - Административная операция [SP2]
На этой странице описана структура административной операции Process3DSAuth на платежном портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG
Структура административной операции Process3DSAuth продукта PC-ECOM-PG представляется в виде XML-запроса отсылаемого на платежный портал ПЦ "Прокард" с варьируемыми параметрами, на который приходит XML-ответ также с варьируемыми параметрами.
Содержание XML-запроса и XML-ответа описываются следующим образом:
XML-запрос
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> |
Описание параметров запроса
Параметр | Нужность | Описание |
|---|---|---|
Operation | Да | Тип операции. Фиксированное значение: Process3DSAuth |
Step | Да | Этап проверки. Фиксированное значение: FIRST |
OrderID | Да | Идентификатор заказа, по которому необходимо выполнить операцию |
Merchant | Да | Идентификатор интернет-магазина. |
SessionID | Да | Идентификатор сессии заказа |
PAN | Да | Номер карты |
PAN2 | Нет | Номер карты получателя. Обязателен при выполнении операции P2PTransfer |
ExpDate | Да | Срок действия карты в формате YYMM. |
CVV2 | Да | CVV2 карты. Если CVV2 не вводился, необходимо преедать значение '-1' (минус один) |
XML-ответ для версии 2.1
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 | Результат выполнения запроса: |
NextStep | Определяет следующий шаг проверки. Фиксированное значение: AREQ |
Operation | Тип выполненной операции |
Refinement | Опциональный блок в ответе, если предоставлены данные от DS. В случае, когда блок присутствует, необходимо инициировать открытие скрытого фрейма в браузере клиента, с помощью которого данные о браузере передаются по протоколу HTTP на URL адрес ACS, полученный в ответе в параметре MethodUrl. После завершения взаимодействия с браузером клиента ACS отправляет соответствующее уведомление в по протоколу HTTP на адрес, указанный в параметре ThreeDSMethodNotificationURL. |
XML-ответ для версии 1.0
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 | Результат выполнения запроса: |
NextStep | Определяет следующий шаг проверки. Фиксированное значение: PARES |
Refinement.RefinementType | Тип данных, которые необходимо передать на следующем этапе: Фиксированное значение: PAREQ |
Refinement.AcsURL | URL-адрес сервера ACS |
Refinement.PAReq | Сообщение PAReq, в POST-сообщении которое необходимо сформировать в браузере покупателя при перенаправлении на ACS эмитента карты. |
Описание параметров XML-ответа для версии non-3DS - финансовая транзакция
XML-ответ имеет следующий формат |
|---|
< Описание полей >
Copyright © 2015-2021 PROCARD