Page History
...
Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8), либо в формате JSON (swagger описание: https://docs.assistbelassist.ruby/swagger/).
URL запроса для получения результатов авторизации:
...
Название  | Обязательное поле  | Принимаемые значения  | Значение по умолчанию  | Описание  | 
Merchant_ID  | Да  | Число  | Идентификатор предприятия в АПК Ассист  | |
Login  | Да  | 8 - 20 символов  | Логин (лат. буквы и цифры, символ _)  | |
Password  | Да  | 8 - 20 символов  | Пароль (лат. буквы и цифры)  | |
TestMode  | Да  | 0 – рабочий режим 1 – тестовый режим  | 0  | Режим работы  | 
Language  | Нет  | RU EN  | EN  | Язык выдачи результатов  | 
Format  | Да/Нет  | 1 – CSV  | 1  | Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POST. Передается только для запроса в формате POST (по умолчанию ответ будет выдан в формате CSV). Для других форматов ответ выдается в том же формате, в котором был выполнен запрос.  | 
MeanType_ID  | Нет  | 1 – VISA  | По умолчанию выборка по всем значениям  | Выборка по типам платежных средств  | 
Operationstate  | Нет  | N – создана;  | По умолчанию выборка по всем значениям  | Выборка по состояниям операций. Регистр должен быть верхний.  | 
Operationtype  | Нет  | A – оплата;  | По умолчанию выборка по всем значениям  | Выборка по типам операций. Регистр должен быть верхний.  | 
StartDay  | Нет  | 01-31  | По умолчанию – минус три часа от текущего времени на момент выборки  | Дата начала выборки по Гринвичу (GMT)  | 
StartMonth  | Нет  | 01-12  | ||
StartYear  | Нет  | YYYY  | ||
StartHour  | Нет  | 00-23  | ||
StartMin  | Нет  | 00-59  | ||
EndDay  | Нет  | 01-31  | По умолчанию - текущее время на момент выборки  | Дата окончания выборки по Гринвичу (GMT)  | 
EndMonth  | Нет  | 01-12  | ||
EndYear  | Нет  | YYYY  | ||
EndHour  | Нет  | 00-23  | ||
EndMin  | Нет  | 00-59  | ||
DateTimeMode  | Нет  | 0 – по дате заказа;  | 0  | Тип даты - целевая дата для выборки данных  | 
ZipFlag  | Нет  | "0" - browser  | 0  | Формат выдачи результатов  | 
...
Название  | Значение  | 
ordernumber  | Номер заказа  | 
billnumber  | Расширенный формат billnumber  | 
testmode  | Тестовый режим  | 
ordercomment  | Комментарий  | 
orderamount  | Оригинальная сумма заказа  | 
ordercurrency  | Оригинальная валюта заказа  | 
amount  | Сумма операции  | 
currency  | Валюта операции  | 
rate  | Курс валюты  | 
lastname  | Фамилия плательщика  | 
firstname  | Имя плательщика  | 
middlename  | Отчество плательщика  | 
Email плательщика  | |
clientip  | IP-адрес совершившего операцию  | 
ipaddress  | IP-адрес плательщика  | 
meantype_id  | ID платежного средства  | 
meantypename  | Тип платежного средства  | 
meansubtype  | Подтип платежного средства  | 
meannumber  | Номер платежного средства  | 
cardholder  | Держатель платежного средства  | 
issuebank  | Название банка-эмитента  | 
bankcountry  | Страна банка-эмитента  | 
orderdate  | Дата заказа по Гринвичу (GMT)  | 
orderstate  | Cтатус заказа  | 
responsecode  | Код возврата  | 
message  | Сообщение  | 
customermessage  | Сообщение о результате для покупателя  | 
recommendation  | Рекомендации  | 
approvalcode  | Код авторизации  | 
protocoltypename  | Протокол  | 
processingname  | Процессинг  | 
operationtype  | Тип операции  | 
operationdate  | Дата и время операции (GMT)  | 
authresult  | Результат авторизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U – неизвестно)  | 
authrequired  | Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – ошибка при определении вовлеченности)  | 
slipno  | Номер финансовой транзакции, отправляемый в процессинг (не используется)  | 
packetdate  | Дата формирования запроса по Гринвичу (GMT)  | 
checkvalue  | uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правиламрезультат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency, orderstate (без разделителей), + строковая склейка.  | 
cardexpirationdate  | Срок действия карты  | 
...
С описанием первого и второго кодов ошибок можно ознакомиться в Таблице "Коды ошибок". Также в соответствующих таблицах описаны возможные статусы заказа, типы операций, коды возврата и коды валют. В качестве значения поля <meannumber> возвращаются первые 6 и последние 4 цифры номера карты, остальные цифры скрыты символом *.
Описание веб-сервиса для формата SOAP можно увидеть на странице:
https://<SERVER-NAME>/resultbydate/resultbydate.wsdl
Пример ответа в формате SOAP:
| Code Block | ||
|---|---|---|
  | ||
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:resultbydateResponse><resultbydate><payment>
<ordernumber>18062012_SDR</ordernumber>
<billnumber>550000110000001.1</billnumber>
<testmode>1</testmode>
<ordercomment>тестовый платеж</ordercomment>
<orderamount>21.00</orderamount>
<ordercurrency>BYN</ordercurrency>
<amount>21.00</amount>
<currency>BYN</currency>
<rate>1</rate>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.by</email>
<clientip>10.10.10.10</clientip>
<ipaddress>0.0.0.0</ipaddress>
<meantype_id>2</meantype_id>
<meantypename>MasterCard</meantypename>
<meansubtype>Standart</meansubtype>
<meannumber>546792****4128</meannumber>
<cardholder>TEST</cardholder>
<issuebank>Bank</issuebank>
<bankcountry>RUS</bankcountry>
<orderdate>06.07.2016 11:10:06</orderdate>
<orderstate>Approved</orderstate>
<responsecode>AS000</responsecode>
<message>Завершено успешно.  </message>
<customermessage>Завершено успешно.  </customermessage>
<recommendation/>
<approvalcode>X40334</approvalcode>
<protocoltypename>NET</protocoltypename>
<processingname>Fake</processingname>
<operationtype>100</operationtype>
<operationdate>06.07.2016 11:10:07</operationdate>
<authresult/>
<authrequired>0</authrequired>
<slipno></slipno>
<packetdate>06.07.2016 11:22:37</packetdate>
<checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue>
<cardexpirationdate>12/20</cardexpirationdate></payment>
</resultbydate></ws:resultbydateResponse ></soapenv:Body></soapenv:Envelope> | 
| Warning | ||
|---|---|---|
  | ||
Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты: 
 Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости.  |