Versions Compared

Old Version 21

changes.mady.by.user Олександр Афанасьєв

Saved on

compared with

New Version Current

changes.mady.by.user Olexandr Dubyna

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 16
Tip

This page describes the structure of the Process3DSAuth administrative operation on the payment portal of the PC "Procard" using На этой странице описана структура административной операции Process3DSAuth на платежном портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG

The structure of the administrative operation Process3DSAuth of the Структура административной операции Process3DSAuth продукта PC-ECOM-PG product is represented as an XML request sent to the payment portal of the PC "Procard" with variable parameters, to which an XML response is also received with variable parameters.

The content of the XML request and XML response are described as follows:

XML-request

XML request has the following format

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

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

XML-запрос

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

Code Block
languagexml
<TKKPG>
 <Request>
  <Operation>Process3DSAuth</Operation>
  <Step>AREQ</Step>
  <Order>
   <OrderID>818</OrderID>
   <Merchant>TEST_TRADER_2</Merchant>
   <AddParams>
    <threeDSCompInd>U</threeDSCompInd>
    <threeDSRequestorAuthenticationInd>01</threeDSRequestorAuthenticationInd>
    <transType>01</transType>
    <messageCategory>01</messageCategory>
   </AddParams>
  </Order>
  <SessionID>F59D2EA727E3B606610EB644D1B05128</SessionID>
  <PAN>4012000000003010</PAN>
  <PAN2/>
  <ExpDate>2012</ExpDate>
  <CVV2>123</CVV2>
  <AReqDetails>
   <OrderID>158544</OrderID>
   <browserAcceptHeader>application/json,application/jose;charset=utf-8</browserAcceptHeader>
   <browserColorDepth>24</browserColorDepth>
   <browserIP>127.0.0.1</browserIP>
   <browserLanguage>ru</browserLanguage>
   <browserScreenHeight>1080</browserScreenHeight>
   <browserScreenWidth>1920</browserScreenWidth>
   <browserTZ>-120</browserTZ>
   <browserUserAgent>Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:70.0) Gecko/20100101 Firefox/70.0</browserUserAgent>
   <threeRIInd/>
   <browserJavaEnabled>false</browserJavaEnabled>
   <notificationUrl>http://sp-provider-post-url</notificationUrl>
   <deviceChannel>02</deviceChannel>
  </AReqDetails>
  <CReqDetails>
   <WindowWidth>1600</WindowWidth>
   <WindowHeight>950</WindowHeight>
  </CReqDetails>
 </Request>
</TKKPG>

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

Table of Contents

Description of request parameters

Parameter

Necessity

Description

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

Challenge-Flow XML response has the following format

Параметр

Нужность

Описание

Operation

Yes

Type of transaction. Fixed valueДа

Тип операции. Фиксированное значение: Process3DSAuth

Step

YesДа

Verification stage. Fixed valueЭтап проверки. Фиксированное значение: AREQ

OrderID

Yes

ID of the order on which the operation is to be performedДа

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

Merchant

Yes

Merchant IDДа

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

AddParams.threeDSCompInd

Yes

A flag indicating the result of a 3DSMethod call.
Fixed valueДа

Признак, указывающий на результат вызова 3DSMethod. Фиксированное значение: U

AddParams.threeDSRequestorAuthenticationInd

Yes

The type of request being made that required Да

Тип выполняемого запроса, для которого возникла необходимость проведения аутентификации 3-D Secure authentication:

  • 01 (paymentплатеж);

  • 02 (periodic paymentпериодический платеж/transferперевод);

  • 03 (partial paymentчастичная оплата);

  • 04 (adding a cardдобавление карты);

  • 05 (card savingсохранение карты);

  • 06 (verification of the cardholder as part of the identification and verification of the EMV token)

If there are no special conditions, the desired value is

  • проверка держателя карты в рамках идентификации и проверки EMV-токена)

Если нет особых условий - желательное значение - 01.

AddParams.transType

Yes

The type of transaction being authenticated. Possible values:

  • 01 - purchase of services / goods;

  • 03 - acceptance of checks for repayment;

  • 10 - replenishment of accounts;

  • 11 - transactions using quasi-cash;

  • 28 - Activate and download prepaid codes

If there are no special conditions, the desired value is Да

Тип аутентифицируемой транзакции. Возможные значения:

  • 01 – покупка услуг / товаров;

  • 03 – прием чеков на отплату;

  • 10 – пополнение счетов;

  • 11 – транзакции с использованием квази-наличных;

  • 28 – активация и загрузка предоплаченных кодов

Если нет особых условий - желательное значение - 01.

AddParams.messageCategory

Yes

Category of the message. Possible valuesДа

Категория сообщения. Возможные значения:

  • 01 - PA (financial transactionфинансовая транзакция);

  • 02 - NPA (non-financial transaction)

Currently supported value

  • нефинансовая транзакция)

На данный момент поддерживается значение: 01 - PA (financial transactionфинансовая транзакция);




AddParams.addrMatch

No

Parameter indicating the match / mismatch of the delivery address of the goods with the address of the cardholder. Possible values:

  • Y - the delivery address of the goods matches the address of the cardholder;

    • N - the delivery address of the goods does not match the address of the cardholder

    Нет

    Параметр, указывающий на совпадение / несовпадение адреса доставки товара с адресом держателя карты. Возможные значения:

    • Y – адрес доставки товара совпадает с адресом держателя карты;

    • N – адрес доставки товара не совпадает с адресом держателя карты

    AddParams.billAddrCity

    No

    City where the cardholder's address is locatedНет

    Город, в котором находится адрес держателя карты

    AddParams.billAddrCountry

    No

    Three-character country code (in Нет

    Трехсимвольный код страны (в формате ISO 3166-1 format) in which the cardholder's address is located), в которой находится адрес держателя карты

    AddParams.billAddrLine1

    No

    First line of the cardholder's addressНет

    Первая строка адреса держателя карты

    AddParams.billAddrLine2

    No

    Second line of the cardholder's addressНет

    Вторая  строка адреса держателя карты

    AddParams.billAddrLine3

    No

    Third line of the cardholder's addressНет

    Третья строка адреса держателя карты

    AddParams.billAddrPostCode

    No

    Postal code of the cardholder's addressНет

    Почтовый индекс адреса держателя карты

    AddParams.billAddrState

    No

    State or province (in Нет

    Штат или область (в формате ISO 3166-2 format) where the cardholder's address is located), в которой находится адрес держателя карты

    AddParams.shipAddrCity

    No

    Delivery cityНет

    Город доставки товара

    AddParams.shipAddrCountry

    No

    Three-character code for the country of delivery of the goods (in Нет

    Трехсимвольный код страны доставки товара (в формате ISO 3166-1 format)

    AddParams.shipAddrLine1

    No

    The first line of the delivery address of the goodsНет

    Первая строка адреса доставки товара

    AddParams.shipAddrLine1

    No

    The second line of the delivery address of the goodsНет

    Вторая  строка адреса доставки товара

    AddParams.shipAddrLine1

    No

    The third line of the delivery address of the goodsНет

    Третья строка адреса доставки товара

    AddParams.shipAddrPostCode

    No

    Postal code of delivery of the goodsНет

    Почтовый индекс доставки товара

    AddParams.shipAddrState

    No

    State or area of ​​delivery of goods in Нет

    Штат или область доставки товара в формате ISO 3166-2 format

    AddParams.email

    No

    Cardholder's email addressНет

    Адрес электронной почты держателя карты

    AddParams.homePhone

    No

    The cardholder's home phone number.

    The parameter value is specified in JSON formatНет

    Номер домашнего телефона держателя карты.

    Значение параметра указывается в формате JSON:

    {"cc": "7", "subscriber": "9998887766"}

    where: cc is the telephone code of the country; subscriber - telephone number (i.e. a sequence of digits assigned to a telephone network subscriberгде: сс – телефонный код страны; subscriber – телефонный номер (т.е. последовательность цифр, присвоенная абоненту телефонной сети)

    AddParams.workPhone

    No

    The cardholder's work phone number. The value of the parameter is specified in the same way as the value of the homePhone parameterНет

    Номер рабочего телефона держателя карты. Значение параметра указывается аналогично значению параметра homePhone

    AddParams.mobilePhone

    No

    Mobile phone number of the cardholder. The value of the parameter is specified in the same way as the value of the homePhone parameter

    Нет

    Номер мобильного телефона держателя карты. Значение параметра указывается аналогично значению параметра homePhone

    AddParams.threeDSRequestorAuthenticationInfo

    No

    Information about the authentication of the cardholder in the online store.

    The parameter value is specified in JSON formatНет

    Информация об аутентификации держателя карты в интернетмагазине.

    Значение параметра указывается в формате JSON.

    {"threeDSReqAuthMethod": "01",
    "threeDSReqAuthTimestamp": "201707071212",
    "threeDSReqAuthData": "kjsn7fh83h4fiiifbsedbf3ins42o5hjo2mdnhiowwer234f4f"}

    whereгде:

    • threeDSReqAuthMethod

    - the method used by the cardholder to authenticate in the online store;

    threeDSReqAuthTimestamp - date and time of cardholder authentication. The value format is YYYYMMDDHHMM;

    threeDSReqAuthData - data about the cardholder authentication procedure

    • – метод, используемый держателем карты для аутентификации в интернет-магазине;

    • threeDSReqAuthTimestamp – дата и время аутентификации держателя карты. Формат значения – YYYYMMDDHHMM;

    • threeDSReqAuthData – данные о процедуре аутентификации держателя карты

    AddParams.threeDSRequestorChallengeInd

    No

    Parameter indicating the need for additional user authentication through a request authentication data. Possible values:

  • 01 - no preference;

  • 02 - additional authentication is not required;

  • 03 – additional authentication requested by merchant;

    • 04 - additional authentication required

    Нет

    Параметр, указывающий на необходимость проведения дополнительной аутентификации пользователя посредством запроса

    аутентификационных данных. Возможные значения:

    • 01 – нет предпочтений;

    • 02 – дополнительная аутентификация не требуется;

    • 03 – дополнительная аутентификация запрошена ТСП;

    • 04 – дополнительная аутентификация требуется

    AddParams.threeDSRequestorPriorAuthenticationInfo

    No

    Information about the authentication of the cardholder in the online store during the previous transaction.

    The parameter value is specified in JSON formatНет

    Информация об аутентификации держателя карты в интернетмагазине при выполнении предыдущей транзакции.

    Значение параметра указывается в формате JSON.

    {"threeDSReqPriorRef": "93f58edb-c916-4b76-ad3a-97b2c0562467",
    "threeDSReqPriorAuthMethod": "01",
    "threeDSReqPriorAuthTimestamp": "201707071212",
    "threeDSReqPriorAuthData": "515615661565 146w451d761a63da65d515615661565146w451d761a63da65d"} where
    где:

    • threeDSReqPriorRef

    is the identifier of the previous transaction, during which the cardholder was successfully authenticated using

    • – идентификатор предыдущей транзакции, при выполнении которой держатель карты был успешно аутентифицирован с использованием 3-D Secure.

    • threeDSReqPriorAuthMethod

    - the method that was used by the cardholder to perform the previous authentication in the online store.

    threeDSReqPriorAuthTimestamp - the date and time of the previous cardholder authentication. The value format is YYYYMMDDHHMM.

    threeDSReqPriorAuthData - data about the previous authentication procedure

    • – метод, который был использован держателем карты для выполнения предыдущей аутентификации в интернет-магазине.

    • threeDSReqPriorAuthTimestamp – дата и время предыдущей аутентификации держателя карты. Формат значения – YYYYMMDDHHMM.

    • threeDSReqPriorAuthData – данные о процедуре предыдущей аутентификации

    AddParams.acctType

    No

    Cardholder account type. Possible valuesНет

    Тип счета держателя карты. Возможные значения:

    • 01 - not applicable– неприменимо;

    • 02 - credit– кредитный;

    • 03 - debit– дебетовый

    AddParams.acctID

    No

    Additional information about the cardholder account in the online storeНет

    Дополнительная информация об учетной записи держателя карты в интернет-магазине

    AddParams.acctInfo

    No

    Additional information about the cardholder's account in the online store.

    The parameter value is specified in JSON formatНет

    Дополнительная информация об учетной записи держателя карты в интернет-магазине.

    Значение параметра указывается в формате JSON.

    {"chAccAgeInd": "1", "chAccDate": "20170707", "chAccChangeInd": "1", "chAccChange": "20170707",
    "chAccPwChangeInd": "1", "chAccPwChange": "20170707", "shipAddressUsageInd": "1",
    "shipAddressUsage": "20170707", "txnActivityDay": "100", "txnActivityYear": "100",
    "provisionAttemptsDay": "100", "nbPurchaseAccount": "1000","suspiciousAccActivity": "1",
    "shipNameIndicator": "1","paymentAccInd": "1","paymentAccAge": "20170707"}
    Whereгде:

    The Merchant's estimated level of risk associated with a particular authentication. The parameter value is specified in JSON format

    • chAccAgeInd – the period of time during which the cardholder's account exists in the online store.

    • chAccDate - the date when the account was created in the online store. The value format is YYYYMMDD.

    • chAccChangeInd - the period of time that has passed since the last receipt of information about the cardholder's account.

    • chAccChange – the date of the last change of the cardholder's account in the online store. The value format is YYYYMMDD.

    • chAccPwChangeInd - The time period since the last account password change or account recovery.

    • chAccPwChange - the date the password was changed or the account was restored. The value format is YYYYMMDD.

    • shipAddressUsageInd - parameter indicating the moment of the first use of the delivery address of the goods specified for this transaction in the online store.

    • shipAddressUsage - the date of the first use of the delivery address of the goods in the online store. The value format is YYYYMMDD.

    • txnActivityDay - the number of transactions carried out by the cardholder through the account in the online store in the last 24 hours.

    • txnActivityYear - the number of transactions carried out by the cardholder through the account in the online store in the last year.

    • provisionAttemptsDay - number of attempts to add a card to the e-wallet in the last 24 hours.

    • nbPurchaseAccount - the number of purchases made by the cardholder through the account in the online store in the last 6 months.

    • suspiciousAccActivity - a parameter indicating the presence / absence of suspicious activity in the cardholder's account.

    • shipNameIndicator – a parameter indicating the match / mismatch of the cardholder's name specified in the account with the name of the recipient of the goods.

    • paymentAccInd is a parameter indicating the period of time during which the payment instrument is registered in the cardholder's account in the online store.

    • paymentAccAge – the date of registration of the payment instrument in the cardholder's account in the online store. Value format - YYYYMMDD

    AddParams.merchantRiskIndicator

    No

    • период времени, в течение которого учетная запись держателя карты существует в интернет-магазине.

    • chAccDate – дата создания учетной записи в интернет-магазине. Формат значения – YYYYMMDD.

    • chAccChangeInd – период времени, прошедший с момента последнего получения информации об учетной записи держателя карты.

    • chAccChange – дата последнего изменения учетной записи держателя карты в интернет-магазине. Формат значения – YYYYMMDD.

    • chAccPwChangeInd – период времени, прошедший с момента последнего изменения пароля учетной записи или восстановления учетной записи.

    • chAccPwChange - дата изменения пароля или восстановления учетной записи. Формат значения – YYYYMMDD.

    • shipAddressUsageInd – параметр, указывающий на момент первого использования адреса доставки товара, заданного для данной транзакции, в интернет-магазине.

    • shipAddressUsage – дата первого использования адреса доставки товара в интернет-магазине. Формат значения – YYYYMMDD.

    • txnActivityDay – количество транзакций, проведенных держателем карты через учетную запись в интернет-магазине за последние 24 часа.

    • txnActivityYear – количество транзакций, проведенных держателем карты через учетную запись в интернет-магазине за последний год.

    • provisionAttemptsDay – количество попыток добавления карты в электронный кошелек за последние 24 часа.

    • nbPurchaseAccount – количество покупок, выполненных держателем карты через учетную запись в интернет-магазине за последние 6 месяцев.

    • suspiciousAccActivity – параметр, указывающий на наличие / отсутствие подозрительной активности в учетной записи держателя карты.

    • shipNameIndicator – параметр, указывающий на совпадение / несовпадение имени держателя карты, заданного в учетной записи, с именем получателя товара.

    • paymentAccInd – параметр, указывающий на период времени, в течение которого платежное средство зарегистрировано в учетной записи держателя карты в интернет-магазине.

    • paymentAccAge – дата регистрации платежного средства в учетной записи держателя карты в интернет-магазине. Формат значения – YYYYMMDD

    AddParams.merchantRiskIndicator

    Нет

    Оцененный ТСП уровень риска, связанного с конкретной аутентификацией. Значение параметра указывается в формате JSON.

    {"shipIndicator": "01","deliveryTimeframe": "1","deliveryEmailAddress": "test@testtest@test.ru","reorderItemsInd": "1","preOrderPurchaseInd": "1","preOrderDate": "20170707","giftCardAmount": "123","giftCardCurr": "643","giftCardCount": "02"}

    Whereгде:

    AReqDetails.browserIP

    Yes

    Browser IP address. Possible value formats:

    • shipIndicator - method of delivery of goods– способ доставки товара.

    • deliveryTimeframe - the delivery time of the goods.

    • deliveryEmailAddress - the email address to which the product was delivered. The parameter is specified for electronic delivery.

    • reorderItemsInd - parameter indicating that the cardholder has reordered an item previously purchased by him.

    • preOrderPurchaseInd - parameter indicating that the cardholder has placed an order for a product that is out of stock.

    • preOrderDate - expected date of product availability. The value format is YYYYMMDD.

    • giftCardAmount - The total amount of prepaid codes or gift cards purchased by the cardholder, in base currency units. For example, for the amount of 123.45 USD, the value is 123.

    • giftCardCurr - currency code of gift cards or prepaid codes purchased by the cardholder. The code is specified in accordance with ISO 4217.

    • giftCardCount - total number of gift cards or prepaid codes purchased by the cardholder

    AddParams.threeDSRequestorNPAInd

    No

    Type of non-financial transaction. Possible values:

    • 01 - adding a card to an electronic wallet;

    • 02 - saving information on the card;

    • 03 - verification of the cardholder as part of the identification and EMV token checks

    AddParams.payTokenInd

    No

    A flag indicating the use of a token instead of a card number. The only possible value is true

    SessionID

    Yes

    Order session ID

    PAN

    Yes

    Card number

    PAN2

    No

    The recipient's card number. Mandatory when performing a P2PTransfer operation

    ExpDate

    Yes

    Card expiration date in YYMM format.

    CVV2

    Yes

    CVV2 cards. If CVV2 was not entered, it is necessary to pass the value '-1' (minus one)

    AReqDetails.OrderID

    Yes

    ID of the order on which the operation is to be performed

    AReqDetails.browserAcceptHeader

    Yes

    The content of the customer's browser HTTP headers. Maximum value - 2048 characters

    AReqDetails.browserColorDepth

    Yes

    A value representing the bit depth of the color palette for displaying images, in bits per pixel. The maximum value is 2 characters.

    Possible values:

    • 1 - 1 bit;

    • 4 - 4 bits;

    • 8 - 8 bits;

    • 15 - 15 bits;

    • 16 - 16 bits;

    • 24 - 24 bits;

    • 32 - 32 bits;

    • 48 - 48 bits.

    • IPv4 address is specified as four groups of numbers in decimal notation, separated by a "." character. For example– срок доставки товара.

    • deliveryEmailAddress – адрес электронной почты, на который был доставлен товар. Параметр указывается для электронной доставки.

    • reorderItemsInd – параметр, указывающий на повторный заказ держателем карты ранее приобретавшегося им товара.

    • preOrderPurchaseInd – параметр, указывающий на размещение держателем карты заказа на товар, отсутствующего в наличии.

    • preOrderDate – ожидаемая дата доступности товара. Формат значения – YYYYMMDD.

    • giftCardAmount – общая сумма предоплаченных кодов или подарочных карт, приобретенных держателем карты, в основных единицах валюты. Например, для суммы 123,45 USD указывается значение 123.

    • giftCardCurr – код валюты подарочных карт или предоплаченных кодов, приобретенных держателем карты. Код указывается в соответствии со стандартом ISO 4217.

    • giftCardCount – общее количество подарочных карт или предоплаченных кодов, приобретенных держателем карты

    AddParams.threeDSRequestorNPAInd


    Тип нефинансовой транзакции. Возможные значения:

    01 – добавление карты в электронный кошелек;

    02 – сохранение информации по карте;

    03 – проверка держателя карты в рамках идентификации и

    проверки EMV-токена

    AddParams.payTokenInd


    Признак, указывающий на использование токена вместо номера карты. Единственное возможное значение – true




    SessionID

    Да

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

    PAN

    Да

    Номер карты

    PAN2

    Нет

    Номер карты получателя. Обязателен при выполнении операции P2PTransfer

    ExpDate

    Да

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

    CVV2

    Да

    CVV2 карты. Если CVV2 не вводился, необходимо преедать значение '-1' (минус один)

    AReqDetails.OrderID

    Да

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

    AReqDetails.browserAcceptHeader

    Да

    Содержимое HTTP-заголовков браузера покупателя. Максимальное значение – 2048 символов

    AReqDetails.browserColorDepth

    Да

    Значение, представляющее битовую глубину цветовой палитры для отображения изображений, в битах на пиксель. Максимальное значение – 2 символа.

    Возможные значения:

    • 1 - 1 бит;

    • 4 - 4 бита;

    • 8 - 8 битов;

    • 15 - 15 битов;

    • 16 - 16 битов;

    • 24 - 24 бита;

    • 32 - 32 бита;

    • 48 - 48 битов

    AReqDetails.browserIP

    Да

    IP-адрес браузера. Возможные форматы значения:

    • IPv4-адрес указан в виде четырех групп чисел в десятичной системе счисления, разделенных символом «.».
      Например: 100.12.123.255.

    • IPv6 address is specified as eight groups of numbers in hexadecimal notation, separated by the ":" character. For example-адрес указан в виде восьми групп чисел в шестнадцатеричной системе счисления, разделенных символом «:».
      Например: 2011: 0db8: 85a3: 0101: 0101: 8a2e: 0370: 7334

    AReqDetails.browserLanguage

    Yes

    Browser language as specified in Да

    Язык браузера, указанный в IETF BCP47. Maximum value - 8 charactersМаксимальное значение – 8 символов

    AReqDetails.browserScreenHeight

    Yes

    The total height (in pixels) of the screen displayed to the cardholder. Maximum value - 6 charactersДа

    Общая высота (в пикселях) экрана, отображаемого держателю карты. Максимальное значение – 6 символов

    AReqDetails.browserScreenWidth

    Yes

    The total width (in pixels) of the screen displayed to the cardholder. Maximum value - 6 charactersДа

    Общая ширина (в пикселях) экрана, отображаемого держателю карты. Максимальное значение – 6 символов

    AReqDetails.browserTZ

    Yes

    The time difference between UTC and the local time of the user's browser. Maximum value - 5 charactersДа

    Разница во времени между временем по UTC и местным временем браузера пользователя. Максимальное значение – 5 символов


    AReqDetails.browserUserAgent

    Yes

    The content of the Да

    Содержимое HTTP-заголовка User-Agent HTTP header. Maximum value - 2048 characters. Максимальное значение – 2048 символов

    AReqDetails.browserJavaEnabled

    Yes

    Ability to execute JavaScript in the cardholder's browser. Possible valuesДа

    Признак возможности выполнения JavaScript в браузере держателя карты. Возможные значения:

    • true

    • false

    AReqDetails.threeRIInd

    Yes

    The type of request that the merchant performs without the participation of the cardholder (recurring payments). Possible valuesДа

    Тип запроса, который выполняет ТСП без участия держателя карты (рекуррентные платежи). Возможные значения:

    • 01 (periodic paymentпериодический платеж/transferперевод);

    • 02 (partial paymentчастичная оплата);

    • 03 (adding cardдобавление карты);

    • 04 (saving card informationсохранение информации о карте);

    • 05 (account identificationидентификация учетной записи);

    • 80-99 (values ​​reserved for DS useзначения зарезервированные для использования DS)

    AReqDetails.notificationUrl

    YesДа

    The URL of the service provider to which the CRes POST message from ACS is returned after performing cardholder verification on URL-адрес сервис провайдера, на который возвращается POST-сообщение CRes от ACS, после выполнения проверки владельца карты при challenge-flow.

    AReqDetails.deviceChannel

    Yes

    The type of device from which the transaction was initiated. Possible valuesДа

    Тип устройства, с которого инициирована транзакция. Возможные значения:

    • 01 - merchant mobile application мобильное приложение ТСП (App-based);

    • 02 - user's browser браузер пользователя(Browser);

    • 03 - интернет- online store магазин (3DS Requestor)

    At the moment, only the value is availableНа данный момент доступно только значение: 02 - the user's browser браузер пользователя(Browser).

    CReqDetails.WindowWidth

    Yes

    Width of the browser window (in pixels) in which pages of the Merchant's website are displayedДа

    Ширина окна браузера (в пикселях), в котором отображаются страницы сайта ТСП

    CReqDetails.WindowHeight

    Yes

    Height of the browser window (in pixels) in which pages of the merchant's website are displayed

    XML response for version 2.1 with challenge-flow and the need to redirect the cardholder to the ACS page

    Да

    Высота окна браузера (в пикселях), в котором отображаются страницы сайта ТСП

    XML-ответ для версии 2.1 при challenge-flow и необходимости перенаправления держателя карты на страницу ACS

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

    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Response>
  <Operation>Process3DSAuth</Operation>
  <NextStep>CRES</NextStep>
  <Refinement>
   <RefinementType>CREQ</RefinementType>
   <AcsURL>https://acs2-test.procard.com.ua/index.jsp</AcsURL>
   <CReq>ewogICJhYх... skip ...]IKfQ==</CReq>
   <AcsChallengeMandated>N</AcsChallengeMandated>
  </Refinement>
  <Status>00</Status>
  <ARes>{ "threeDSServerTransID" : "b256141f-3e02-45cd-8d77-3129d01a7bed", "acsTransID" : "de56da5e-56cc-4f03-9a0d-4accfe320096", "dsTransID" : "f7b253a3-3011-4dfe-b336-a6ad91ab6f77", "messageType" : "ARes", "messageVersion" : "2.1.0", "acsReferenceNumber" : "3DS_LOA_ACS_PPFU_020100_00013", "acsChallengeMandated" : "N", "acsOperatorID" : "acsOperatorUL", "acsURL" : "https://acs2-test.procard.com.ua/index.jsp", "authenticationType" : "03", "dsReferenceNumber" : "LOCAL_DS_123", "transStatus" : "C" }</ARes>
</Response>
</TKKPG>
    Description of XML response parameters for

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

    version

    ParameterПараметр

    DescriptionОписание

    StatusResult of the request

    Refinement.RefinementType

    Результат выполнения запроса:
    00

    - successful

    – успешно
    30

    - invalid message format (no required parameters, etc

    – неверный формат сообщения (нет обязательных параметров и т. д.)
    10

    - merchant does not have access to the order creation operation (or such merchant is not registered)

  • 54 - invalid operation

  • 72 - system error

  • 96 - system error

  • 97 - system error

    • NextStep

    Specifies the next validation step. Fixed value: CRES

    Operation

    Type of operation performed

    Type of data to be passed in the next step: Fixed value– интернет-магазин не имеет доступа к операции создания заказа (или такой интернет-магазин не зарегистрирован)
    54 – недопустимая операция
    72 – системная ошибка
    96 – системная ошибка
    97 – системная ошибка

    NextStep

    Определяет следующий шаг проверки. Фиксированное значение: CRES

    Operation

    Тип выполненной операции

    Refinement.RefinementType

    Тип данных, которые необходимо передать на следующем этапе: Фиксированное значение: CREQ

    Refinement.AcsURL

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

    Refinement.CReq

    Сообщение CReq message, in a POST message that needs to be generated in the customer's browser when redirected to the card issuer's ACSв POST-сообщении которое необходимо сформировать в браузере покупателя при перенаправлении на ACS эмитента карты.

    Refinement.AcsChallengeMandated

    Indicates that a Challenge Flow script needs to be run due to local/regional mandate requirements

    ValuesПризнак необходимости выполнения сценария Challengу Flow по причине локальных/региональных мандатных требований

    Значения: Y/N

    ARes

    ARes message received from the issuer's ACS in JSON format

    Description of XML response parameters for

    Полученное от ACS эмитента сообщение ARes в формате JSON

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

    version

    -

    financial transaction

    финансовая транзакция

    XML response has the following format-ответ имеет следующий формат

    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
 <Response>
  <Operation>Process3DSAuth</Operation>
  <Status>00</Status>
  <Result>
   <XMLOut>(FieldОписание descriptionsполей seeсм. belowниже)</XMLOut>
  </Result>
 </Response>
</TKKPG>

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

    Filter by label (Content by label)
    type
    showLabelsfalse
    spacesAPI
    showSpacefalse
    sorttitle
    showSpacetypefalsepage
    titleRelated pagesСвязанные страницы:
    pagecqllabel = "поставщики-услуг" and type = "page" and parent = "26939886261203667225"
    labelsdocumentation-space-sample