4.4. Process3DSAuth - результат выполнения финансовой транзакции [SP2]
На этой странице описаны особенности формирования оповещения о статусе оплаты заказа клиента при проведении административной операции CreateOrder на платежном портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG
На этой странице:
Пример XML
XML-сообщение имеет следующий формат |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Response>
<Operation>Process3DSAuth</Operation>
<Status>00</Status>
<Result>
<XMLOut>
<Message date="25/01/2017 10:15:58">
<Version>1.0</Version>
<OrderID>5973</OrderID>
<TransactionType>Purchase</TransactionType>
<RRN>713091</RRN>
<RRN2>713092</RRN2>
<PAN>455555XXXX1903</PAN>
<PAN2>425555XXXX1499</PAN2>
<PurchaseAmount>5000</PurchaseAmount>
<Fee>0</Fee>
<Currency>840</Currency>
<TranDateTime>25/01/2017 10:15:58</TranDateTime>
<ResponseCode>001</ResponseCode>
<ResponseDescription>Удачное выполнение транзакции</ResponseDescription>
<Brand>VISA</Brand>
<OrderStatus>APPROVED</OrderStatus>
<ApprovalCode>340623 A</ApprovalCode>
<AcqFee>0</AcqFee>
<RezultOperation>Результат операции</RezultOperation>
<MerchantTranID>3133343537383739303837343030303030303030</MerchantTranID>
<OrderDescription>xxxxxxxx</OrderDescription>
<ApprovalCodeScr>340623</ApprovalCodeScr>
<PurchaseAmountScr>50,00</PurchaseAmountScr>
<CurrencyScr>Гривня</CurrencyScr>
<OrderStatusScr>Одобрен</OrderStatusScr>
<ThreeDSVerificaion>Y</ThreeDSVerificaion>
<ThreeDSStatus>Approved</ThreeDSStatus>
<Name>Sidorov Ivan I.</Name>
</Message>
</XMLOut>
</Result>
</Response>
</TKKPG> |
Параметры XML-сообщения
Параметр | Нужность | Пример значения | Описание |
|---|---|---|---|
Message | Да | Документ в форма | |
Version | Да | 1.0 | Версия протокола. Текущая 1.0 |
OrderID | Да | 4584-87854 | Уникальный номер заказа |
TransactionType | Да | Purchase | Тип операции |
OrderStatus | Да | APPROVED или DECLINED | Состояние заказа |
OrderStatusScr | Да | Одобрена или Отклонена | Текстовое описание состояния |
PAN | Да | 4555 55XX XXXX 5487 | Маскированный номер карты |
PAN2 | Нет | 4255 55XX XXXX 5544 | Маскированный номер карты получателя (параметр заполнен для переводов) |
Brand | Да | VISA, MC | Платежная система |
Language | Нет | RU – русский, EN – английский, UK – украинский, и т. д. | Язык интерфейса клиента. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка |
PurchaseAmount | Да | 15210 | Сумма транзакции в копейках |
PurchaseAmountScr | Да | 152,10 | Сумма транзакции, отформатированная для отображения клиенту |
Fee | Нет | 0 | Сумма комиссии в копейках |
Currency | Да | 980 - гривня | Код валюты транзакции |
CurrencyScr | Да | Гривня | Текстовое описание валюты транзакции |
Name | Нет | Sidorov Ivan I. | Имя клиента на карте |
TranDateTime | Да | 15/02/2003 15:37 | Дата и время выполнения транзакции |
ApprovalCode | Да | 548789 | Код подтверждения (номер чека) |
ApprovalCodeScr | Да | 548789 | Код подтверждения |
ThreeDSVerificaion | Да | Y | Флаг выполнения проверки карты по технологии 3-D Secure. Статус выполнения транзакций U / A содержится в сообщении PARes Параметр отсутствует в XMLсообщении, для 3-Dsecure 2.1 |
RezultOperation | Да | Результат операции | Результат выполнения операции |
ThreeDSStatus | Нет | APPROVED или DECLINED | Статус проверки по технологии 3- D Secure. Заполняется в случае выполнения проверки Параметр отсутствует в XMLсообщении, для 3-Dsecure 2.1 |
ResponseCode | Нет | 0402 | Код ответа авторизационного хоста. Заполняется в случае отклонения транзакции. |
ResponseDescription | Нет | Недостаточно средств на счете | Описание отказа в авторизации. Передается на языке интерфейса клиента. Заполняется в случае отклонения транзакции |
Response_g | Нет | Russia | Текстовое поле, в котором отображается дополнительная информация (например, валюта счета, номер счета, страна держателя карты и др.). |
AcqFee | Нет | 0 | Сумма эквайринговой комиссии |
MerchantTranID | Нет | 31333435373837393 | Уникальный номер транзакции клиента. Параметр генерируется |
OrderDescription | Нет | Покупка | Текстовое описание заказа |
Response_f | Да | 123456 | Предоплаченный код |
xid | Да | MTQ0ODI4MTU5NzY0 | Уникальный идентификатор транзакции, определяемый ТСП |
CalculatedCAVV | Да | 31343637363234313 | Значение параметра CAVV |
RRN | Да | 700593 | Внешний идентификатор транзакции |
RRN2 | Да | 700594 | Внешний идентификатор транзакции |
HexCAVV | Да | 31343733333237363 | Значение CAVV, используемое в 3-D Secure транзакции, в формате HEX |
Идентификация результата успешного выполнения финансовой транзакции
В данном разделе описываются ключевые параметры для идентификации успешности выполнения финансовой транзакции из XML-ответа на операции Process3DSAuth.
Параметр | Значение | Обяз. поле | Описание |
|---|---|---|---|
OrderStatus | APPROVED | Да | Состояние заказа |
ResponseCode | 001 | Да | Код ответа авторизационного хоста |
ApprovalCodeScr | B0358C | Рекомендуется | Код подтверждения |
TranId | 123456781 | Условно | ID транзакции авторизационного хоста |
RRN | 700593 | Условно | Внешний идентификатор транзакции |
RR2 | 700594 | Условно | Внешний идентификатор транзакции |
AuthorizationResponseCode | 01 | Да | Авторизационный код ответа хоста |
ResponseDescription | Approved, no balances available | Условно | Описание ответа авторизации. Передается на языке интерфейса клиента |
Примечание:
Рекомендуется анализировать набор параметров в ответе Process3DSAuth, для точной идентификации успешности финансовой операции.
В описании данного раздела представлены ключевые параметры, однако торговец может использовать дополнительные поля, которые возвращаются в ответе Process3DSAuth, детали описаны выше.
Связанные страницы
Copyright © 2015-2021 PROCARD