Page History

...

Список параметров, передаваемых в режиме silentpay:

*Передача данных покупателя не является обязательной, но при отсутствии поля  email  клиенту не будет отправлены уведомление об оплате и фискальный чек даже в том случае, если у мерчанта установлены соответствующие настройки. При отсутствии этих параметров также будут ограничены возможности работы системы СПМ и передача дополнительных параметров аутентификации по протоколу 3-D Secure версии 2.

...

<FORM ACTION="https://SERVER-NAME/pay/silentpay.cfm " method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="Login" VALUE="Ваш логин">
<INPUT TYPE="hidden" NAME="Password" VALUE="Ваш пароль">
<INPUT TYPE="hidden" NAME="OrderNumber" VALUE="011001-10">
<INPUT TYPE="hidden" NAME="OrderAmount" VALUE="22">
<INPUT TYPE="hidden" NAME="OrderCurrency" VALUE="KZT">
<INPUT TYPE="hidden" NAME="OrderComment" VALUE="оплата заказа 011001-10">
<INPUT TYPE="hidden" NAME="Delay" VALUE="0">
<INPUT TYPE="hidden" NAME="isConvert" VALUE="1">
<INPUT TYPE="hidden" NAME="Language" VALUE="RU">
<INPUT TYPE="hidden" NAME="ClientIP" VALUE="IP адрес покупателя">
<INPUT TYPE="hidden" NAME="Cardtype" VALUE="Тип карты">
<INPUT TYPE="hidden" NAME="Cardnumber" VALUE="Номер карты">
<INPUT TYPE="hidden" NAME="Cardholder" VALUE="Владелец карты">
<INPUT TYPE="hidden" NAME="Expiremonth" VALUE="срок действия карты - месяц">
<INPUT TYPE="hidden" NAME="Expireyear" VALUE=" срок действия карты - год">
<INPUT TYPE="hidden" NAME="Cvc2" VALUE="код CVC2 или CVV2">
<INPUT TYPE="hidden" NAME="Lastname" VALUE="Фамилия покупателя">
<INPUT TYPE="hidden" NAME="Firstname" VALUE="Имя покупателя">
<INPUT TYPE="hidden" NAME="Middlename" VALUE="Отчество покупателя">
<INPUT TYPE="hidden" NAME="Email" VALUE="Email покупателя">
<INPUT TYPE="hidden" NAME="Address" VALUE="Адрес покупателя ">
<INPUT TYPE="hidden" NAME="Homephone" VALUE="Домашний телефон покупателя">
<INPUT TYPE="hidden" NAME="Workphone" VALUE="Рабочий телефон покупателя">
<INPUT TYPE="hidden" NAME="Mobilephone" VALUE="Мобильный телефон покупателя">
<INPUT TYPE="hidden" NAME="Fax" VALUE="Факс покупателя">
<INPUT TYPE="hidden" NAME="Country" VALUE="Страна">
<INPUT TYPE="hidden" NAME="State" VALUE="Регион">
<INPUT TYPE="hidden" NAME="City" VALUE="Город">
<INPUT TYPE="hidden" NAME="Zip" VALUE="Индекс отделения связи">
<INPUT TYPE="hidden" NAME="TestMode" VALUE="Тестовый режим">
<INPUT TYPE="hidden" NAME="Format" VALUE="Формат представления результата">
<INPUT TYPE="hidden" NAME="GenerateReceipt" VALUE="1">
<INPUT TYPE="hidden" NAME="Tax" VALUE="Идентификатор ставки налога">
<INPUT TYPE="hidden" NAME="ReceiptLine" VALUE="Наименование позиции чека">
<INPUT TYPE="hidden" NAME="FPMode" VALUE="Признак способа расчета">
<INPUT TYPE="Submit"></FORM>

Описание вебОписание веб-сервиса для формата SOAP:

...

При оплате картой, требующей авторизации по 3D-Secure, АПК Ассист возвращает код ответа (responsecode) AS110. В пакет ответа по режиму silentpay также добавляются дополнительные поля, позволяющие ТСП обеспечить дополнительную аутентификацию плательщика по технологиям 3-D Secure (карты VISA и, Mastercard SecureCode.

В настоящее время для дополнительной аутентификации плательщика многие банки-эмитенты работают по версии 1 протокола 3-D Secure для всех типов карт.Для более надежного процесса аутентификации банки-эмитенты и платежные системы переходят на новую версию 2 и выше протокола для всех типов карт (VISA, Mastercard). Для поддержки протокола нового поколения предприятию нужно внести изменения в процесс аутентификации плательщика.применяется версия протокола 2.0 для всех типов карт

Для начала оплаты заказа предприятие отправляет  авторизационный запрос  на сервер АПК Ассист. К обычным параметрам запроса необходимо добавить следующие данные об устройстве и браузере клиента . В новом протоколе 3-D Secure версии 2 эти данные являются обязательными.

<FORM ACTION="acsurl - значение, полученное от АПК Ассист в пакете режима silentpay" method="POST">
<INPUT TYPE="hidden" NAME="PaReq" VALUE="pareq - значение, полученное от АПК Ассист в пакете режима silentpay ">
<INPUT TYPE="hidden" NAME="TermUrl" VALUE="url магазина для получения результата от банка-эмитента">
<INPUT TYPE="hidden" NAME="MD" VALUE="любые данные магазина">
<INPUT TYPE="submit" NAME="Submit_3DS" class="button" VALUE="Продолжить">
</FORM>

...

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<send3dsparams xmlns="urn:assist-processor">
<merchant_id>Идентификатор предприятия</merchant_id>
<login>Ваш логин</login>
<password>Ваш пароль</password>
<ordernumber>Номер заказа</ordernumber>
<language>Язык</language>
<pares>Значение, полученное в пакете результата от банка-эмитента</pares>
</send3dsparams>
<s:Body>
<s:Envelope>

<?xml version="1.0" encoding="windows-1251" standalone="no" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Fault>
<faultcode>Первый код</faultcode>
<faultstring>Второй код</faultstring>
<detail />
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3D-Secure авторизация по протоколу версии 2

...

1. Проверять версию протокола 3D-Secure в ответе на  авторизационный запрос  к сервису Assist. Для версии 1 поддерживать описанную выше  схему работы.
2. Для версии 2 сформировать скрытый Iframe на платежной странице (детальное описание параметров см. ниже) и отправить на ACS банка-эмитента запрос 3DSMethod (при наличии).
3. Для продолжения аутентификации вызвать веб-сервис ws3dsecver2 get3dsec ver 2  с дополнительными параметрами 3D-Secure. Если аутентификация произойдет без дополнительного взаимодействия с клиентом (Frictionless Flow), то АПК Ассист получит ее результат и отправит транзакцию авторизации в процессинг. В ответе предприятие получит полный результат оплаты, содержащий также и результат авторизации в процессинге. В случае необходимости дополнительной аутентификации клиента АПК Ассист вернет в ответе на запрос дополнительные поля для проведения проверки.
4. При наличии в ответе дополнительных полей, сообщающих о необходимости дополнительной проверки (Challenge Flow), предприятие на платежной странице формирует IFrame, в котором реализует отображение страницы ACS банка-эмитента для ввода одноразового пароля. Покупатель завершает аутентификацию.
5. При наличии в ответе дополнительных полей, сообщающих о возможности отложенной аутентификации (Decoupled Authentication), предприятие ожидает результата прохождения проверки. Аутентификация покупателя может быть пройдена альтернативным способом, поддерживаемым банком-эмитентом (например, через push-уведомление на телефоне и аутентификацию по Face id или отпечатку пальца в приложении банка-эмитента).
6. Результат прохождения проверки АПК Ассист получит на сервер на своей стороне (для Challenge Flow и Decoupled Authentication). В случае успешной проверки будет проведена транзакция оплаты в процессинге. В случае неуспешной проверки операция завершится с ошибкой.
7. Для того чтобы узнать окончательный результат оплаты заказа, предприятию необходимо использовать один из методов получения результата авторизации.

...

Для начала оплаты заказа предприятие отправляет  авторизационный запрос   и необходимые дополнительные параметры на сервер АПК Ассист (блок 1). Также могут использоваться  необязательные дополнительные параметры .

ри При оплате картой, требующей авторизации по протоколу версии 2, АПК Ассист вернет в ответе код возврата AS110 (блок 2) и дополнительный блок параметров  threedsdata . Полный список параметров, которые могут содержаться в блоке  threedsdata,  представлен в таблице ниже:

¹ Параметр может содержаться в ответе сервиса: 1-  silentpay ; 2 -  get 3 dsecver 2 .

² В случае авторизации без дополнительной проверки (Frictionless Flow)  и для отложенной аутентификации (Decoupled authentication)  параметры  challengeurl  и  challengerequest  не будут возвращены.

В зависимости от содержания полученного блока  threedsdata  (блоки 3,7,8) аутентификация продолжается по-разному.

Основные сценарии работы для версии 2 определяются тем, требуется ли вызов  3DSMethod  (формирование скрытого iFrame в браузере клиента), а также требуется ли дополнительная аутентификация клиента и по какому сценарию она проходит :

• При наличии URL банка-эмитента  threeDSMethodURL  (блок 7) предприятие формирует скрытый HTML iFrame на платежной странице (блок 9), отправляет POST запрос с одним параметром  threeDSMethodData  на полученный адрес  threeDSMethodURL , и далее вызывает сервис get3dsecver2 (блок 10).
• При наличии URL банка-эмитента  threeDSMethodURL  (блоки 7, 9, 10), но без необходимости дополнительного взаимодействия с держателем карты (блок 8) -  Frictionless Flow (F) , АПК Ассист сразу проводит транзакцию в процессинге или завершает операцию с ошибкой.  В ответе на вызов сервиса get3dsecver2 предприятие получит статус оплаты (блок 6).
• При наличии URL банка-эмитента  threeDSMethodURL  (блоки 7, 9, 10) и при необходимости дополнительного взаимодействия с держателем карты (блок 8) предприятие должно сформировать на платежной странице объект HTML iFrame и отправить методом HTTP POST запрос проверки держателя карты к указанному URL  challengeurl  (блок 11). В этом iFrame отображается страница ACS банка эмитента и плательщик вводит одноразовый пароль, полученный от банка. Это сценарий  Challenge Flow (C).
• При наличии URL банка-эмитента  threeDSMethodURL  (блоки 7, 9, 10) при необходимости дополнительного взаимодействия с держателем карты (блок 8) и отложенной аутентификации предприятие должно оставить заказ в состоянии  В Процессе  и ожидать окончательного статуса оплаты (в рамках времени жизни заказа). Это сценарий  Decoupled Authentication (D).
• При отсутствии URL банка-эмитента  threeDSMethodURL  и когда дополнительное взаимодействие с держателем карты не требуется -  Frictionless Flow (F) , сразу же будет проведена транзакция в процессинге, и процесс оплаты будет завершен (блок 6).  Предприятие получит результат аутентификации и статус оплаты сразу в ответе на вызов сервиса  silentpay.
• При отсутствии URL банка-эмитента  threeDSMethodURL  и при необходимости дополнительного взаимодействия с держателем карты (блок 8) для сценария  Challenge Flow (C)  предприятие должно сформировать на платежной странице объект HTML iFrame и отправить методом HTTP POST запрос проверки держателя карты к указанному URL  challengeurl  (блок 11). В этом iFrame отображается страница ACS банка эмитента и плательщик вводит одноразовый пароль, полученный от банка.
• При отсутствии URL банка-эмитента  threeDSMethodURL  и при необходимости дополнительного взаимодействия с держателем карты (блок 8) по сценарию отложенной аутентификации (D) предприятие должно оставить заказ в состоянии  В Процессе  и ожидать окончательного статуса оплаты (в рамках времени жизни заказа).

В тех сценариях работы, в которых требуется формирование скрытого HTML iFrame, на шаге 7 в блоке   threedsdata  предприятие получит  необходимые параметры  threeDSMethodData  и  threeDSMethodURL   для формирования POST запроса (блок 9). Результат отправки запроса может быть положительным (код HTTP 200), отрицательным (любой другой код HTTP) или будет превышено значение тайм-аута отправки запроса (установить 10 секунд). После получения кода HTTP или истечения тайм-аута для продолжения процесса аутентификации необходимо отправить запрос на сервис  get3dsecver2  (блок 10) .

get3dsecver2 - веб-сервис продолжения аутентификации по 3D-Secure

URL для передачи запроса:

https://<SERVER-NAME>/ get3dsec/ get3dsec ver 2.cfm

Поддерживаемые форматы: SOAP, JSON.

Входные параметры:

АПК Ассист продолжает процесс аутентификации плательщика в платежной системе и банке-эмитенте через 3DS Server.

Если дополнительная проверка покупателя не требуется (Frictionless Flow) (блок 8), АПК Ассист  проводит транзакцию в процессинге или завершает операцию с ошибкой (в зависимости от настроек процессинга, предприятия и результата аутентификации) (блок 6).

Ответ на запрос в этом случае будет содержать один из конечных кодов возврата (AS000 - операция успешно завершена, AS100-AS109 - отказ в авторизации), все поля ответа, описанные  выше , и дополнительный блок данных  threedsdata , в котором параметр  challenge  равен F, а поле  alphaauthresult  содержит результат аутентификации  (Y, N, U, R, I ).

Получение кода возврата AS110 в ответе на вызов сервиса  get3dsecver2  означает, что нужна дополнительная проверка плательщика (Challenge Flow).  Для сценария с дополнительной проверкой (Challenge Flow)  в блоке данных  threedsdata  параметр  challenge  будет равен  C , а параметры  challengeurl  и  challengerequest  будут заполнены (блок 8). Предприятие должно в этом случае сформировать на платежной странице объект HTML iFrame и отправить методом HTTP POST запрос проверки держателя карты к указанному URL (блок 11) с параметром  creq , в котором передать полученное значение  challengerequest . В этом iFrame отображается страница ACS банка-эмитента и плательщик вводит одноразовый пароль, полученный от банка.

В сценарии с отложенной аутентификацией в блоке данных  threedsdata  параметр  challenge  будет равен  D , а параметры  challengeurl  и  challengerequest  будут отсутствовать (блок 8). Предприятие должно в этом случае оставить заказ в состоянии  В Процессе  и ожидать окончательного статуса оплаты.

Результат этой проверки АПК Ассист получит на свой сервер в асинхронном режиме. В зависимости от результата аутентификации и настроек процессинга и предприятия, АПК Ассист проведет транзакцию оплаты в процессинге или закроет операцию с ошибкой.

Для того, чтобы после прохождения дополнительной проверки плательщик смог вернуться обратно на сайт предприятия, следует сообщить службе поддержки АПК Ассист URL для возврата покупателя и приема результата прохождения дополнительной проверки.  Для предприятия получение этого запроса будет означать, что дополнительная проверка завершена, и оно может в этот момент перенаправить браузер плательщика на страницу результата на своей стороне и ожидать завершения платежной транзакции в процессинге.

Получение результата платежа после дополнительной проверки отражено на схеме блоками 12, 13, 14.

Пример блока данных  threedsdata , в котором дополнительной проверки держателя не требуется (при этом код возврата responsecode будет отличен от AS110):

<threedsdata>
<version>2.2</version>
<alphaauthresult>Y</alphaauthresult>
<challenge>F<challenge>
</threedsdata>

Пример блока данных threedsdata, в котором требуется дополнительная проверка держателя (код возврата responsecode равен AS110):

<threedsdata>
<version>2.2</version>
<challenge>С<challenge>
<challengeurl>https://acs.superbank.ru/version20/creq</challengeurl>
<challengerequest>eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImE3ZWJlMDU3LTg2ZjgtNGFmMS05MTJkHGNlYTc5Mzc0OWUxMiIsImFjc1RyYW5zSUQiOiI5ODhmOWZmYS1kNzYyLTQ0YjktOWI0OS01ZDRkMjU5YmRkZWQiLCJkc1RyYW5zSUQiOiJkMGJmZGQzYy00YzdhLTVmNjktODAwMC0wMDAwMDAwOGM3NjMiLCJtZXNzYWdlVHlwZSI6IkNSеZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA0In0</challengerequest>
</threedsdata>

Чтобы получить ответ веб-сервиса в формате JSON, нужно передать в запросе content-type=application/json или format=5.

Описание параметров всех веб-сервисов АПК Ассист для формата JSON содержится в файле swagger по адресу:

https://docs.assist.kz/swagger/

Пример ответа в формате JSON для операции без дополнительной аутентификации:

{
    "threedsdata": {
        "version": "2.2",
        "alphaauthresult": "Y",
        "challenge": "F"
    },
    "silentpay": {
        "customermessage": "Завершено успешно",
        "message": "Завершено успешно",
        "testmode": 0,
        "operationtype": 100,
        "orderdate": "05.04.2022 11:19:54",
        "packetdate": "05.04.2022 11:19:58",
        "orderamount": 31.79,
        "ordercomment": "",
        "cardexpirationdate": "12/23",
        "ordercurrency": "KZT",
        "recommendation": "",
        "processingname": "Credx",
        "meannumber": "554373****0010",
        "orderstate": "Approved",
        "rate": 1,
        "amount": 31.79,
        "responsecode": "AS000",
        "meantypename": "MasterCard",
        "protocoltypename": "NET",
        "bankcountry": "Казахстан",
        "customer": {
            "lastname": "Test",
            "firstname": "Auto",
            "middlename": "",
            "ipaddress": "127.0.0.1",
            "email": "null@assist.kz"
        },
        "cardholder": "TEST",
        "approvalcode": "489489",
        "billnumber": "5817109255129315.1",
        "issuebank": "BANK",
        "currency": "KZT",
        "ordernumber": "856a13d9-e9a0-4d3c-9d02-b82db6bae03e",
        "meansubtype": "Platinum MasterCard Salary-Immediate Debit"
    }
}

Пример ответа для операции c дополнительной аутентификацией:

{    
    "threedsdata": {
        "version": "2.2.0",
        "challengerequest": "eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjQxMWI2ODVjLWUzODAtNGZkYS05YmIzLWJiZjM2OTJiNGMyNiIsImFjc1RyYW5zSUQiOiJmY2FlMDMzNS0xODgwLTRlNjgtOWJjMy0wMDcyZDM4ZTkzODYiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDIiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0",
        "challengeurl": "https://fake.3dss.t.paysecure.ru/acs/challenge",
        "challenge": "C"
    },
    "MakePaymentResponse": {
        "customermessage": "Создана Аутентификация клиента по технологии 3DSecure",
        "message": "Создана Аутентификация клиента по технологии 3DSecure",
        "testmode": 0,
        "operationtype": 100,
        "orderdate": "05.04.2022 11:19:32",
        "packetdate": "05.04.2022 11:19:34",
        "orderamount": 31.79,
        "ordercomment": "",
        "cardexpirationdate": "12/23",
        "ordercurrency": "KZT",
        "recommendation": "",
        "processingname": "Credx",
        "meannumber": "554373****6654",
        "orderstate": "In Process",
        "rate": 1,
        "amount": 31.79,
        "responsecode": "AS110",
        "meantypename": "MasterCard",
        "protocoltypename": "NET",
        "bankcountry": "Казахстан",
        "customer": {
            "lastname": "Test",
            "firstname": "Auto",
            "middlename": "",
            "ipaddress": "127.0.0.1",
            "email": "null@assist.kz"
        },
        "cardholder": "TEST",
        "approvalcode": "",
        "billnumber": "5817109255129273.1",
        "issuebank": "BANK",
        "currency": "KZT",
        "ordernumber": "6b510f3d-1327-4f3b-bc17-612daeed3aac",
        "meansubtype": "Platinum MasterCard Salary-Immediate Debit"
    }
}

Назад