Приложение 9. Выполнение операции с использованием 3DS2 по Токену

На этой странице описан принцип выполнения операции с использованием 3DS2 по Токену на портале ПЦ "Прокард" с использованием продукта PC-ECOM-PG

Использование кошельков для оплаты на страницах сервис провайдеров возможно после их интеграции с платежными сервисами GooglePay/ApplePay/ Other.

Для выполнения операции необходимо получить данные токена от системы GooglePay/ApplePay/Other согласно соответствующего протокола взаимодействия.

В случае, когда GooglePay/ApplePay/Other возвращает чистый PAN, а не номер токена, транзакцию необходимо формировать как обычную, а не токен-транзакцию.

Для формирования транзакции GooglePay/ApplePay/Other с использованием технологии 3DS2 (при использовании технологии 3DSecure и Токена одновременно - необходимо передать значение TAVV и CAVV (после проверки 3DS)) необходимо заполнить соответствующие поля протокола специальным образом в операции CreateOrder.


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

  1. Сервер сервис-провайдера отправляет административный POST-запрос по адресу PayURL о регистрации заказа на покупку (административная операция CreateOrder для Purchase). Также в административной операции CreateOrder, в блок Order необходимо передать параметры:
    AddParams → DSRPFlag = 1.
    AddParams → MasterPassWalletId = ХХХ
    AddParams → TokenCryptogram = 01000000000002f75e0ba6eab7b3a8415f010410
    Данные TAVV передаются на этапе создания заказа в теге TokenCryptogram:

    • по картам платежной системы VISA криптограмму токена необходимо передавать в преобразованном формате из base64 в hex.

    Пример:

    base64 = AQAAAAAAAvdeC6bqt7OoQV8BBBB=
    hex = 01000000000002f75e0ba6eab7b3a8415f010410

    • по картам платежной системы MasterCard криптограмму токена необходимо передавать в чистом виде.

    Пример: 

    AQAAAAAAAvdeC6bqt7OoQV8BBBB=

  2. В ответ сервер сервис-провайдера получает уникальный номер заказа, идентификатор сессии и интернет адрес.

  3. Сервер сервис-провайдера формирует административный запрос на проверку версии карты в программе 3D-Secure. Process3DSAuth - FIRST). Исходя из полученного ответа на Административной операции FIRST, сервер сервис-провайдера переходит к следующему шагу, описанному в разделе Этапы проверки 3-D Secure 2.1 / Этапы проверки 3-D Secure 1.0.

  4. При необходимости (в случае сбоев или возникновения других нештатных ситуаций) сервер сервис-провайдера может инициировать запрос о статусе оплаты заказа (административная операция GetOrderStatus) или информации о заказе (административная операция GetOrderInformation).

  5. Для инициирования возврата средств, сервер сервис-провайдера может инициировать операцию Refund / Reverse.

Административная операция CreateOrder для 3DS2 с использованием Токена:

<?xml version="1.0" encoding="UTF-8"?> <TKKPG> <Request> <Operation>CreateOrder</Operation> <Language></Language> <Order> <OrderType>Purchase</OrderType> <Merchant></Merchant> <Amount></Amount> <Currency></Currency> <Description></Description> <email></email> <phone></phone> <ApproveURL></ApproveURL> <DeclineURL></DeclineURL> <CancelURL></CancelURL> <Fee></Fee> <AddParams> <DSRPFlag>1</DSRPFlag> <MasterPassWalletId>XXX</MasterPassWalletId> <TokenCryptogram>01000000000002f75e0ba6eab7b3a8415f010410</TokenCryptogram> </AddParams> </Order> </Request> </TKKPG>

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

Параметр

Нужность

Описание

Параметр

Нужность

Описание

Language

Да

Язык интерфейса. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка (например, RU – русский, EN – английский, UK – украинский и т. д.)

OrderType

Да

Тип заказа. Параметр определяет финансовую транзакцию, которая будет впоследствии сформирована. Для выполнения покупки следует указать значение Purchase

Merchant

Да

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

Amount

Да

Сумма транзакции в копейках

Currency

Да

Код валюты транзакции (980-гривня)

Description

Да

Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты.

email

Нет

E-mail клиента (дополнительный параметр), который можно сохранить в БД.

phone

Нет

Номер телефона клиента (дополнительный параметр), который можно сохранить в БД.

ApproveURL

Нет

URL для перенаправления в случае успешной операции (APPROVE).

DeclineURL

Нет

URL для перенаправления в случае отказа (DECLINE).

CancelURL

Нет

URL для перенаправления в случае отмены (CANCEL).

MITAttributes

Нет

Признаки транзакции, инициированной с вводом карточных данных (или их аналога), для операций с использованием токена использовать значение = 1.

DSRPFlag

Да

Признак транзакции, инициированной с помощью мобильного приложения (технология DSRP). Возможные значения:

  • 0 (по умолчанию) – транзакция инициирована без использования технологии DSRP;

  • 1 (использовать для операции по токену) – транзакция инициирована с использованием технологии DSRP.

MasterPassWalletId

Да

Идентификатор электронного кошелька.

TokenCryptogram

Да

TAVV/DTVV/DSRP криптограмма, которая используется при проведении 3-D Secure аутентификации для транзакций, выполняемых по токену.

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


Связанные страницы:

There are no items with the selected labels at this time.

Copyright © 2015-2021 PROCARD