Параметр | Нужность | Описание |
---|---|---|
Operation | Да | Тип операции. Фиксированное значение: Process3DSAuth |
Step | Да | Этап проверки. Фиксированное значение: AREQ |
OrderID | Да | Идентификатор заказа, по которому необходимо выполнить операцию |
Merchant | Да | Идентификатор интернет-магазина. |
AddParams.threeDSCompInd | Да | Признак, указывающий на результат вызова 3DSMethod. Фиксированное значение: U |
AddParams.threeDSRequestorAuthenticationInd | Да | Тип выполняемого запроса, для которого возникла необходимость проведения аутентификации 3-D Secure:
Если нет особых условий - желательное значение - 01. |
AddParams.transType | Да | Тип аутентифицируемой транзакции. Возможные значения:
Если нет особых условий - желательное значение - 01. |
AddParams.messageCategory | Да | Категория сообщения. Возможные значения:
На данный момент поддерживается значение: 01 - PA (финансовая транзакция); |
AddParams.addrMatch | Нет | Параметр, указывающий на совпадение / несовпадение адреса доставки товара с адресом держателя карты. Возможные значения:
|
AddParams.billAddrCity | Нет | Город, в котором находится адрес держателя карты |
AddParams.billAddrCountry | Нет | Трехсимвольный код страны (в формате ISO 3166-1), в которой находится адрес держателя карты |
AddParams.billAddrLine1 | Нет | Первая строка адреса держателя карты |
AddParams.billAddrLine2 | Нет | Вторая строка адреса держателя карты |
AddParams.billAddrLine3 | Нет | Третья строка адреса держателя карты |
AddParams.billAddrPostCode | Нет | Почтовый индекс адреса держателя карты |
AddParams.billAddrState | Нет | Штат или область (в формате ISO 3166-2), в которой находится адрес держателя карты |
AddParams.shipAddrCity | Нет | Город доставки товара |
AddParams.shipAddrCountry | Нет | Трехсимвольный код страны доставки товара (в формате ISO 3166-1) |
AddParams.shipAddrLine1 | Нет | Первая строка адреса доставки товара |
AddParams.shipAddrLine1 | Нет | Вторая строка адреса доставки товара |
AddParams.shipAddrLine1 | Нет | Третья строка адреса доставки товара |
AddParams.shipAddrPostCode | Нет | Почтовый индекс доставки товара |
AddParams.shipAddrState | Нет | Штат или область доставки товара в формате ISO 3166-2 |
AddParams.email | Нет | Адрес электронной почты держателя карты |
AddParams.homePhone | Нет | Номер домашнего телефона держателя карты. Значение параметра указывается в формате JSON: {"cc": "7", "subscriber": "9998887766"} где: сс – телефонный код страны; subscriber – телефонный номер (т.е. последовательность цифр, присвоенная абоненту телефонной сети) |
AddParams.workPhone | Нет | Номер рабочего телефона держателя карты. Значение параметра указывается аналогично значению параметра homePhone |
AddParams.mobilePhone | Нет | Номер мобильного телефона держателя карты. Значение параметра указывается аналогично значению параметра homePhone |
AddParams.threeDSRequestorAuthenticationInfo | Нет | Информация об аутентификации держателя карты в интернетмагазине. Значение параметра указывается в формате JSON. {"threeDSReqAuthMethod": "01", где:
|
AddParams.threeDSRequestorChallengeInd | Нет | Параметр, указывающий на необходимость проведения дополнительной аутентификации пользователя посредством запроса аутентификационных данных. Возможные значения:
|
AddParams.threeDSRequestorPriorAuthenticationInfo | Нет | Информация об аутентификации держателя карты в интернетмагазине при выполнении предыдущей транзакции. Значение параметра указывается в формате JSON. {"threeDSReqPriorRef": "93f58edb-c916-4b76-ad3a-97b2c0562467",
|
AddParams.acctType | Нет | Тип счета держателя карты. Возможные значения:
|
AddParams.acctID | Нет | Дополнительная информация об учетной записи держателя карты в интернет-магазине |
AddParams.acctInfo | Нет | Дополнительная информация об учетной записи держателя карты в интернет-магазине. Значение параметра указывается в формате JSON. {"chAccAgeInd": "1", "chAccDate": "20170707", "chAccChangeInd": "1", "chAccChange": "20170707",
|
AddParams.merchantRiskIndicator | Нет | Оцененный ТСП уровень риска, связанного с конкретной аутентификацией. Значение параметра указывается в формате JSON. {"shipIndicator": "01","deliveryTimeframe": "1","deliveryEmailAddress": "test@test.ru","reorderItemsInd": "1","preOrderPurchaseInd": "1","preOrderDate": "20170707","giftCardAmount": "123","giftCardCurr": "643","giftCardCount": "02"} где:
|
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 символа. Возможные значения:
|
AReqDetails.browserIP | Да | IP-адрес браузера. Возможные форматы значения:
|
AReqDetails.browserLanguage | Да | Язык браузера, указанный в IETF BCP47. Максимальное значение – 8 символов |
AReqDetails.browserScreenHeight | Да | Общая высота (в пикселях) экрана, отображаемого держателю карты. Максимальное значение – 6 символов |
AReqDetails.browserScreenWidth | Да | Общая ширина (в пикселях) экрана, отображаемого держателю карты. Максимальное значение – 6 символов |
AReqDetails.browserTZ | Да | Разница во времени между временем по UTC и местным временем браузера пользователя. Максимальное значение – 5 символов |
AReqDetails.browserUserAgent | Да | Содержимое HTTP-заголовка User-Agent. Максимальное значение – 2048 символов |
AReqDetails.browserJavaEnabled | Да | Признак возможности выполнения JavaScript в браузере держателя карты. Возможные значения:
|
AReqDetails.threeRIInd | Да | Тип запроса, который выполняет ТСП без участия держателя карты (рекуррентные платежи). Возможные значения:
|
AReqDetails.notificationUrl | Да | URL-адрес сервис провайдера, на который возвращается POST-сообщение CRes от ACS, после выполнения проверки владельца карты при challenge-flow. |
AReqDetails.deviceChannel | Да | Тип устройства, с которого инициирована транзакция. Возможные значения:
На данный момент доступно только значение: 02 - браузер пользователя(Browser). |
CReqDetails.WindowWidth | Да | Ширина окна браузера (в пикселях), в котором отображаются страницы сайта ТСП |
CReqDetails.WindowHeight | Да | Высота окна браузера (в пикселях), в котором отображаются страницы сайта ТСП |
XML-ответ Challenge-Flow имеет следующий формат | |
---|---|
|
Параметр | Описание |
---|---|
Status | Результат выполнения запроса: |
NextStep | Определяет следующий шаг проверки. Фиксированное значение: CRES |
Operation | Тип выполненной операции |
Refinement.RefinementType | Тип данных, которые необходимо передать на следующем этапе: Фиксированное значение: CREQ |
Refinement.AcsURL | URL-адрес сервера ACS |
Refinement.CReq | Сообщение CReq, в POST-сообщении которое необходимо сформировать в браузере покупателя при перенаправлении на ACS эмитента карты. |
Refinement.AcsChallengeMandated | Признак необходимости выполнения сценария Challengу Flow по причине локальных/региональных мандатных требований Значения: Y/N |
ARes | Полученное от ACS эмитента сообщение ARes в формате JSON |
XML-ответ имеет следующий формат | |
---|---|
|
< Описание полей >