Page History
...
Название  | Обязательное поле  | Принимаемыезначения  | Значениепо умолчанию  | Описание  | ||||
Merchant_ID  | Да  | Число  | Идентификатор предприятия в системе АПК Ассист  | |||||
Login  | Да  | Строка  | Ваш логин  | |||||
Password  | Да  | Строка  | Ваш пароль  | |||||
OrderNumber  | Да/Нет  | 128 символов  | Номер заказа в системе расчетов предприятия.  | |||||
OrderAmount  | Да  | Число, 15 цифр (разделители «.», «,»)  | Сумма платежа в оригинальной валюте (например, 10.34)  | |||||
OrderCurrency  | Нет  | 3 символа  | Валюта юр.лица или предприятия  | Код валюты, в которой указана сумма платежа OrderAmount (RUB, USD, EUR)  | ||||
OrderComment  | Нет  | 4000 символов  | Комментарий  | |||||
Delay  | Нет  | 0 - одностадийный механизм работы,  | 0  | Признак авторизации банковской карты при двустадийном механизме работы 
  | ||||
Language  | Нет  | RU - русский  | Язык юр.лица или предприятия  | Язык авторизационных страниц  | ||||
ClientIP  | Нет/Да  | IP адрес покупателя. Параметр является обязательным для протокола 3-D Secure версии 2.  | ||||||
Cardtype  | Нет  | 1 - VISA  | Идентификатор типа карты для оплаты.  | |||||
Cardnumber  | Да  | Номер карты  | ||||||
Cardholder  | Да  | 70 символов без цифр. Разделитель - пробел.  | Держатель карты.  | |||||
Expiremonth  | Да  | 1-12  | Месяц окончание действия карты  | |||||
Expireyear  | Да  | Год в формате YYYY  | Год окончания действия карты  | |||||
Cvc2  | Да  | CVC2 код  | ||||||
Lastname  | Да  | 70 символов без цифр  | Фамилия покупателя  | |||||
Firstname  | Да  | 70 символов без цифр  | Имя покупателя  | |||||
Middlename  | Нет  | 70 символов без цифр  | Отчество покупателя  | |||||
Да  | 128 символов  | E-mail покупателя  | ||||||
Address  | Нет  | 256 символов  | Адрес покупателя  | |||||
HomePhone  | Нет  | 64 символа  | Домашний телефон покупателя  | |||||
WorkPhone  | Нет  | 20 символов  | Рабочий телефон покупателя  | |||||
MobilePhone  | Нет  | 20 символа  | Мобильный телефон покупателя  | |||||
Country  | Нет  | 3 символа  | Код страны покупателя  | |||||
State  | Нет  | 3 символа  | Код региона покупателя  | |||||
City  | Нет  | 70 символа  | Город покупателя  | |||||
Zip  | Нет  | 25 символа  | Индекс предприятия связи покупателя  | |||||
isConvert  | Нет  | 0 - Не конвертировать в базовую валюту 1 - Не конвертировать при возможности 2 - Всегда конвертировать  | 1  | Флаг конвертации валюты платежа в базовую валюту  | ||||
Format  | Нет  | 1 - CSV  | 1  | Формат выдачи результата. Если запрос передан в формате SOAP или JSON, то ответ также будет в SOAP или JSON соответственно, в остальных случаях ответ выдается согласно переданному значению формата.  | ||||
Signature  | Нет  | строка  | Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест.  Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа  - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64. 
 
  | |||||
RecurringIndicator  | Нет  | 1 - рекуррентный платеж 0 - обычный платеж  | 0  | Признак рекуррентного платежа 
  | ||||
RecurringMinAmount  | Нет/Да  | Число, 15 цифр (разделители «.», «,»)  | Минимальная сумма рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1 
  | |||||
RecurringMaxAmount  | Нет/Да  | Число, 15 цифр (разделители «.», «,»)  | Максимальная сумма рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1 
  | |||||
RecurringPeriod  | Нет/Да  | Число, 10 цифр  | Периодичность рекуррентных платежей в днях. Параметр обязателен при RecurringIndicator = 1 
  | |||||
RecurringMaxDate  | Нет/Да  | Строковое представление даты в формате DD.MM.YYYY  | Дата окончания рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1 
  | |||||
| CustomerNumber | Нет | 32 символа | Внутренний номер клиента предприятия (мерчанта) 
  | |||||
| SaveCard | Нет | 1 - карта привязывается к данному номеру клиента; 0 - карта не привязывается | 0 | В случае успешного платежа разрешает сохранять карту по данному номеру клиента для последующих платежей. Если карта для данного номера клиента уже была сохранена ранее, то параметр игнорируется. | ||||
| Disable3DS | Нет | 0 - проверять 3-D Secure согласно настройкам предприятия, 1 - проводить платеж без 3-D Secure.  | 0 | Признак отключения 3-D Secure. 
 
  | 
...
При оплате картой, требующей авторизации по 3D-Secure, АПК Ассист возвращает код ответа (responsecode) AS110. В пакет ответа по режиму silentpay также добавляются дополнительные поля, позволяющие ТСП обеспечить дополнительную аутентификацию плательщика по технологиям 3-D Secure (карты VISA) и Mastercard SecureCode (карты Mastercard ).В настоящее время для дополнительной аутентификации плательщика большинство банков-эмитентов работает по версии 1 протокола плательщика по технологиям 3-D Secure по всем типам карт.(карты VISA) и Mastercard SecureCode (карты Mastercard ).
Для карт международных платежных систем VISA, Mastercard в большинстве случаев используется версия 2 протокола 3D-Secure при дополнительной аутентификации плательщика, эта же версия протокола применяется и для карт UPI. Для карт платежной системы БЕЛКАРТ аутентификация осуществляется по версии 1 протоколаДля более надежного процесса аутентификации банки-эмитенты и платежные системы переходят на новую версию 2 и выше протокола для всех типов карт (VISA, Mastercard). Для поддержки протокола нового поколения предприятию нужно внести изменения в процесс аутентификации плательщика.
Для начала оплаты заказа предприятие отправляет авторизационный запрос на сервер АПК Ассист. К обычным параметрам запроса необходимо добавить следующие данные об устройстве и браузере клиента, если это еще не было сделано ранее для работы с СПМ. В новом протоколе 3-D Secure версии 2 эти данные являются обязательными.
...
- Проверять версию протокола 3D-Secure в ответе на авторизационный запрос к сервису Assist. Для протокола версии 1 поддерживать описанную выше схему работы.
 - Для протокола версии 2 сформировать скрытый iframe на платежной странице (детальное описание параметров см. ниже) и отправить на ACS банка-эмитента запрос 3DSMethod (при наличии).
 - Для продолжения аутентификации вызвать веб-сервис ws3dsecver2 get3dsecver2 с дополнительными параметрами 3D-Secure. Если аутентификация произойдет без дополнительного взаимодействия с клиентом (Frictionless Flow), то АПК Ассист получит ее результат и отправит транзакцию авторизации в процессинг. В ответе предприятие получит полный результат оплаты, содержащий также и результат авторизации в процессинге. В случае необходимости дополнительной аутентификации клиента АПК Ассист вернет в ответе на запрос дополнительные поля для проведения проверки (Challenge Flow).
 - При наличии в ответе дополнительных полей, сообщающих о необходимости дополнительной проверки, предприятие на платежной странице формирует iFrame, в котором реализует отображение страницы ACS банка-эмитента для ввода одноразового пароля. Покупатель завершает аутентификацию.
 - Результат прохождения проверки АПК Ассист получит на сервер на своей стороне. В случае успешной проверки будет проведена транзакция оплаты в процессинге. В случае неуспешной проверки операция завершится с ошибкой.
 - Для того чтобы узнать окончательный результат оплаты заказа, предприятию необходимо использовать один из методов получения результата авторизации.
 
...