www.belassist.by

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

Предприятие может также узнать результаты операций по заказам, проведенным за указанный период, с помощью веб-сервиса.

Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8), либо в формате JSON (swagger описание: https://docs.assist.ru/swagger/). 

URL запроса для получения результатов авторизации:

https://<SERVER-NAME>/resultbydate/resultbydate.cfm.

Получить результаты операций при помощи веб-сервиса можно только за промежуток времени, не превышающий сутки. Для этого нужно указать такие значения параметров, задающих дату начала выборки, и параметров, задающих дату окончания выборки, чтобы разница между этими датами составляла не более суток. В противном случае для этих параметров будут использованы значения по умолчанию (за последние 3 часа). Иными словами, если параметры, определяющие дату начала и дату окончания выборки, не заданы или заданы неверно, в результате запроса будут выведены результаты операций, совершенных за последние три часа. Обратите внимание, что параметры, задающие дату и время выборки, необходимо передавать по Гринвичу (GMT/UTC). Выборка производится по дате заказа.

Если клиент прервал процесс оплаты раньше, чем выбрал тип платежного средства, то в системе АПК Ассист не будет создана операция оплаты, и выборке не будет операций по данному заказу.

Внимание! Запрашивать результаты операций можно за промежуток времени, не превышающий одни сутки, и не чаще, чем один раз в 10 минут.

Список параметров запроса:

Название

Обязательное поле

Принимаемые значения

Значение по умолчанию

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в АПК Ассист

Login

Да

8 - 20 символов 


Логин (лат. буквы и цифры, символ _)

Password

Да

8 - 20 символов


Пароль (лат. буквы и цифры)

TestMode

Да

0 – рабочий режим

1 – тестовый режим

0

Режим работы

Language

Нет

RU

EN

EN

Язык выдачи результатов

Format

Да/Нет

1 – CSV
3 – XML
4 – SOAP
5 - JSON

4

Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POST

MeanType_ID

Нет

1 – VISA
2 – MasterCard
5  – AMEX
33 – Mobicon
38 - ERIP

По умолчанию выборка по всем значениям

Выборка по типам платежных средств

Operationstate

Нет

N – создана;
P – в процессе обработки;
S – завершена успешно;
F – завершена неуспешно;
T – закрыта по истечению времени

По умолчанию выборка по всем значениям

Выборка по состояниям операций. Регистр должен быть верхний.

Operationtype

Нет

A – оплата;
C – подтверждение оплаты;
R – отмена

По умолчанию выборка по всем значениям

Выборка по типам операций. Регистр должен быть верхний.

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 – по дате заказа;
1 – по дате начала операции;
2 – по дате окончания операции.

0

Тип даты - целевая дата для выборки данных

ZipFlag

Нет

"0" - browser
"1" - file
"2" - ZIP

0

Формат выдачи результатов

Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл. "Правила валидации входных параметров".

На основании значений параметров, переданных на сервер АПК Ассист в запросе о результатах операций, производится выборка информации и определяется формат и вид результата.

Например, в результате запроса могут быть выведены только успешные операции оплаты по картам VISA.

Пример запроса HTTP POST для получения результатов, возвращающий информацию об успешных операциях оплаты по картам VISA в тестовом режиме с 07:00 до 11:00 (GMT) 06.07.2016 в формате 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="06">
<INPUT TYPE="hidden" NAME="StartMonth" VALUE="07">
<INPUT TYPE="hidden" NAME="StartYear" VALUE="2016">
<INPUT TYPE="hidden" NAME="StartHour" VALUE="07">
<INPUT TYPE="hidden" NAME="StartMin" VALUE="00">
<INPUT TYPE="hidden" NAME="EndDay" VALUE="06">
<INPUT TYPE="hidden" NAME="EndMonth" VALUE="07">
<INPUT TYPE="hidden" NAME="EndYear" VALUE="2016">
<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>

Список параметров ответа: