Предприятие может также узнать результаты операций по заказам, проведенным за указанный период, с помощью веб-сервиса.
Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом 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 | Формат выдачи результатов |
Примечание
Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл. Правила валидации входных параметров.