Предприятие может также узнать результаты операций по заказам, проведенным за указанный период, с помощью веб-сервиса.
Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8), либо в формате JSON (swagger описание: https://docs.assist.kz/swagger/).
URL запроса для получения результатов авторизации:
https://<SERVER-NAME>/resultbydate/resultbydate.cfm.
Получить результаты операций при помощи веб-сервиса можно только за промежуток времени, не превышающий сутки. Для этого нужно указать такие значения параметров, задающих дату начала выборки, и параметров, задающих дату окончания выборки, чтобы разница между этими датами составляла не более суток. В противном случае для этих параметров будут использованы значения по умолчанию (за последние 3 часа). Иными словами, если параметры, определяющие дату начала и дату окончания выборки, не заданы или заданы неверно, в результате запроса будут выведены результаты операций, совершенных за последние три часа. Обратите внимание, что параметры, задающие дату и время выборки, необходимо передавать по Гринвичу (GMT/UTC). Выборка производится по дате заказа.
Если клиент прервал процесс оплаты раньше, чем выбрал тип платежного средства, то в системе АПК Ассист не будет создана операция оплаты, и выборке не будет операций по данному заказу.
Внимание!
Запрашивать результаты операций можно за промежуток времени, не превышающий одни сутки, и не чаще, чем один раз в 10 минут.
Список параметров запроса:
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 8 - 20 символов | Логин (лат. буквы и цифры, символ _) | |
Password | Да | 8 - 20 символов | Пароль (лат. буквы и цифры) | |
Language | Нет | RU EN | EN | Язык выдачи результатов |
Format | Да/Нет | 1 – CSV | 1 | Формат выдачи результатов. Передается только для запроса в формате 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 | Формат выдачи результатов |
Примечание
Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл. Правила валидации входных параметров.
На основании значений параметров, переданных на сервер АПК Ассист в запросе о результатах операций, производится выборка информации и определяется формат и вид результата.
Например, в результате запроса могут быть выведены только успешные операции оплаты по картам VISA.
Пример запроса HTTP POST для получения результатов, возвращающий информацию об успешных операциях оплаты по картам VISA в тестовом режиме с 07:00 до 11:00 (GMT) 01.03.2011 в формате XML:
<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 | Срок действия карты |
Внимание!
В полученном ответе необходимо проверить значение параметра testmode. Если платеж был выполнен в тестовом режиме (testmode=1), то отгружать товар или оказывать услугу по текущему заказу не требуется.