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. 
 
  | 
...
Название  | Принимаемые значения  | Описание  | 
HEADER_HTTP_ACCEPT  | Строка, 255 байт  | Заголовок http запроса ACCEPT  | 
HEADER_HTTP_USER_AGENT  | Строка, 255 байт  | Заголовок http запроса USER-AGENT  | 
CLIENT_JAVA  | Логическое (true, false)  | navigator.javaEnabled()  | 
CLIENT_BROWSER_LANGUAGE  | Строковый (5 байт)  | navigator. language  | 
CLIENT_SCREEN_COLORS  | Числовой (1, 4,8,15,16,24,32,48)  | Screen.pixelDepth  | 
CLIENT_SCREEN_RES  | Строковый, 16 символов  | Screen.width + 'x' + screen.height  | 
ChallengeWindowSize  | 2 символа (01 – - 250x400, 02 – - 390x400, 03 – - 500x600, 04 – - 600x400, 05 – - Full screen)  | Размер iframe для прохождения проверки держателя карты  | 
ClientIP  | Максимум 15 цифр, 4 разделителя «.»  | IP адрес покупателя  | 
...
Для продолжения процесса авторизации по 3D-Secure магазину необходимо передать в АПК Ассист пакет результата авторизации по 3D-Secure pares. Данная функциональность реализована в веб-сервисе get3DSec.
Get3DSec – - веб-сервис передачи параметров авторизации карты по 3D-Secure
...
Название  | Принимаемые значения  | Описание  | В ответе сервиса1  | 
version  | Версия протокола 3-D Secure  | 1,2  | |
threeDSServerTransID  | Строка  | ID транзакции в 3DS Server  | 1,2  | 
threeDSMethodURL  | Строка, до 256 символов  | URL на стороне банка-эмитента или платежной системы  | 1  | 
threeDSMethodData  | Строка, до 256 символов  | Закодированное в Base64 тело запроса  | 1  | 
alphaauthresult  | Y - успешно, N - неуспешно, A - Attempt, U – - невозможно провести аутентификацию, R- отказ, E - ошибка, I - для информации  | Результат аутентификации будет получен в ответе, если она произошла в одну стадию (Frictionless Flow)  | 1,2  | 
challenge  | F - Frictionless Flow  | Взаимодействие с держателем карты (C – - нужно, F – - не нужно, D - отложенная аутентификация)  | 1,2  | 
challengeurl2  | Полное доменное имя (URL) https://acs.... Длина максимум 2048 символов  | URL банка-эмитента или платежной системы для проверки плательщика  | 1,2  | 
challengerequest2  | Сообщение, закодированное методом Base64, длина переменная  | Данные запроса, отправляемого на challengeurl  | 1,2  | 
...
1Параметр может содержаться в ответе сервиса: 1- silentpay; 2 –- get3dsecver2.
| Anchor | ||||
|---|---|---|---|---|
  | 
2В случае авторизации без дополнительной проверки (Frictionless Flow) и для отложенной аутентификации (Decoupled authentication) параметры challengeurl и challengerequest не будут возвращены.
...
Ответ на запрос в этом случае будет содержать один из конечных кодов возврата (AS000 – - операция успешно завершена, AS100-AS109 – - отказ в авторизации), все поля ответа, описанные выше, и дополнительный блок данных threedsdata, в котором параметр challenge равен F, а поле alphaauthresult содержит результат аутентификации (Y, N, U, R, I).
...