Page History
...
Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8), либо в формате JSON (swagger описание: https://docs.assist.ru/swagger/).
URL запроса для получения результатов авторизации:
https://<SERVER-NAME>/resultbydate/resultbydate.cfm.
Получить результаты операций при помощи веб-сервиса можно только за промежуток времени, не превышающий сутки. Для этого нужно указать такие значения параметров, задающих дату начала выборки, и параметров, задающих дату окончания выборки, чтобы разница между этими датами составляла не более суток. В противном случае для этих параметров будут использованы значения по умолчанию (за последние 3 часа). Иными словами, если параметры, определяющие дату начала и дату окончания выборки, не заданы или заданы неверно, в результате запроса будут выведены результаты операций, совершенных за последние три часа. Обратите внимание, что параметры, задающие дату и время выборки, необходимо передавать по Гринвичу (GMT/UTC). Выборка производится по дате заказа.
...
Список параметров запроса:
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 8 - 20 символов | Логин (лат. буквы и цифры, символ _) | |
Password | Да | 8 - 20 символов | Пароль (лат. буквы и цифры) | |
Language | Нет | RU EN | EN | Язык выдачи результатов |
Format | Да/Нет | 1 – CSV |
3 – XML |
5 - JSON | 1 | Формат выдачи результатов. |
MeanType_ID
Передается только для запроса в формате POST (по умолчанию ответ будет выдан в формате CSV). Для других форматов ответ выдается в том же формате, в котором был выполнен запрос. | ||
MeanType_ID | Нет | 1 – VISA |
39 – QIWIBeeline
40 – QIWIMts
41 - QIWIMegafon
По умолчанию выборка по всем значениям | Выборка по типам платежных средств | |||
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 | Нет |
"1" - file
"
0 – по дате заказа; | 0 | Тип даты - целевая дата для выборки данных | ||
ZipFlag | Нет | "0" - browser | 0 | Формат выдачи результатов |
| Multiexcerpt include | ||||
|---|---|---|---|---|
|
...
| Code Block | ||
|---|---|---|
| ||
<FORM ACTION="https://<SERVER-NAME>/resultbydate/resultbydate.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="TestMode" VALUE="1">
<INPUT TYPE="hidden" NAME="Language" VALUE="EN">
<INPUT TYPE="hidden" NAME="MeanType_ID" VALUE="1">
<INPUT TYPE="hidden" NAME="Operationstate" VALUE="S">
<INPUT TYPE="hidden" NAME="Operation type" VALUE="A">
<INPUT TYPE="hidden" NAME="StartDay" VALUE="01">
<INPUT TYPE="hidden" NAME="StartMonth" VALUE="03">
<INPUT TYPE="hidden" NAME="StartYear" VALUE="2018">
<INPUT TYPE="hidden" NAME="StartHour" VALUE="07">
<INPUT TYPE="hidden" NAME="StartMin" VALUE="00">
<INPUT TYPE="hidden" NAME="EndDay" VALUE="01">
<INPUT TYPE="hidden" NAME="EndMonth" VALUE="03">
<INPUT TYPE="hidden" NAME="EndYear" VALUE="2018">
<INPUT TYPE="hidden" NAME="EndHour" VALUE="11">
<INPUT TYPE="hidden" NAME="EndMin" VALUE="00">
<INPUT TYPE="hidden" NAME="DateTimeMode" VALUE="1">
<INPUT TYPE="hidden" NAME="Format" VALUE="3">
<INPUT TYPE="Submit"></FORM> |
...
Название | Значение |
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 | Срок действия карты |
...
Описание веб-сервиса для формата SOAP можно увидеть на странице:
https://<SERVER-NAME>/resultbydate/resultbydate.wsdl
Пример ответа в формате SOAP:
...
| Multiexcerpt include | ||||
|---|---|---|---|---|
|
| Warning |
|---|
...
|
...
| |
Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты:
Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости. |
...