Предприятие может также узнать результаты операций по заказам, проведенным за указанный период, с помощью веб-сервиса.
Для получения результатов авторизации нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).
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 | 4 | Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POST |
MeanType_ID | Нет | 1 – VISA 2 – MC 3 – DCL 4 – JCB 5 – AMEX 30 – WebMoney 32 – YandexMoney 36 – QIWI 39 – QIWIBeeline 40 – QIWIMts 41 - QIWIMegafon | По умолчанию выборка по всем значениям | Выборка по типам платежных средств |
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 | ||
ZipFlag | Нет | "0" - browser | 0 | Формат выдачи результатов |
Примечание. Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл.5.15 .
На основании значений параметров, переданных на сервер АПК Ассист в запросе о результатах операций, производится выборка информации и определяется формат и вид результата.
Например, в результате запроса могут быть выведены только успешные операции оплаты по картам 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="2011"> <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="2011"> <INPUT TYPE="hidden" NAME="EndHour" VALUE="11"> <INPUT TYPE="hidden" NAME="EndMin" VALUE="00"> <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 | Срок действия карты |
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://www.paysecure.ru/ws/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="resultbydate" targetNamespace="http://www.paysecure.ru/ws/"> <wsdl:types> <xsd:schema targetNamespace="http://www.paysecure.ru/ws/"> <xsd:complexType name="operationResult"> <xsd:all> <xsd:element name="ordernumber" type="xsd:string" /> <xsd:element name="billnumber" type="xsd:string" /> <xsd:element name="testmode" type="xsd:string" /> <xsd:element name="ordercomment" type="xsd:string" /> <xsd:element name="orderamount" type="xsd:string" /> <xsd:element name="ordercurrency" type="xsd:string" /> <xsd:element name="amount" type="xsd:string" /> <xsd:element name="currency" type="xsd:string" /> <xsd:element name="rate" type="xsd:string" /> <xsd:element name="firstname" type="xsd:string" /> <xsd:element name="lastname" type="xsd:string" /> <xsd:element name="middlename" type="xsd:string" /> <xsd:element name="email" type="xsd:string" /> <xsd:element minOccurs="0" name="clientip" type="xsd:string" /> <xsd:element minOccurs="0" name="ipaddress" type="xsd:string" /> <xsd:element name="meantype_id" type="xsd:string" /> <xsd:element name="meantypename" type="xsd:string" /> <xsd:element name="meansubtype" type="xsd:string" /> <xsd:element name="meannumber" type="xsd:string" /> <xsd:element name="cardholder" type="xsd:string" /> <xsd:element name="cardexpirationdate" type="xsd:string" /> <xsd:element name="issuebank" type="xsd:string" /> <xsd:element name="bankcountry" type="xsd:string" /> <xsd:element name="orderdate" type="xsd:string" /> <xsd:element name="orderstate" type="xsd:string" /> <xsd:element name="responsecode" type="xsd:string" /> <xsd:element name="message" type="xsd:string" /> <xsd:element name="customermessage" type="xsd:string" /> <xsd:element name="recommendation" type="xsd:string" /> <xsd:element name="approvalcode" type="xsd:string" /> <xsd:element name="protocoltypename" type="xsd:string" /> <xsd:element name="processingname" type="xsd:string" /> <xsd:element name="operationtype" type="xsd:string" /> <xsd:element name="operationdate" type="xsd:string" /> <xsd:element name="authresult" type="xsd:string" /> <xsd:element name="authrequired" type="xsd:string" /> <xsd:element name="packetdate" type="xsd:string" /> <xsd:element name="slipno" type="xsd:string" /> <xsd:element minOccurs="0" name="signature" type="xsd:string" /> <xsd:element minOccurs="0" name="checkvalue" type="xsd:string" /> </xsd:all> </xsd:complexType> <xsd:complexType name="result"> <xsd:sequence> <xsd:element maxOccurs="unbounded" name="payment" type="tns:operationResult" /> </xsd:sequence> </xsd:complexType> </xsd:schema> </wsdl:types> <wsdl:message name="ResultByDateRequest"> <wsdl:part name="merchant_id" type="xsd:string" /> <wsdl:part name="login" type="xsd:string" /> <wsdl:part name="password" type="xsd:string" /> <wsdl:part name="testmode" type="xsd:string" /> <wsdl:part name="language" type="xsd:string" /> <wsdl:part name="format" type="xsd:string" /> <wsdl:part name="meantype_id" type="xsd:string" /> <wsdl:part name="operationstate" type="xsd:string" /> <wsdl:part name="operationtype" type="xsd:string" /> <wsdl:part name="startyear" type="xsd:string" /> <wsdl:part name="startmonth" type="xsd:string" /> <wsdl:part name="startday" type="xsd:string" /> <wsdl:part name="starthour" type="xsd:string" /> <wsdl:part name="startmin" type="xsd:string" /> <wsdl:part name="endyear" type="xsd:string" /> <wsdl:part name="endmonth" type="xsd:string" /> <wsdl:part name="endday" type="xsd:string" /> <wsdl:part name="endhour" type="xsd:string" /> <wsdl:part name="endmin" type="xsd:string" /> <wsdl:part name="zipflag" type="xsd:string" /> </wsdl:message> <wsdl:message name="ResultByDateResponse"> <wsdl:part name="resultbydate" type="tns:result" /> </wsdl:message> <wsdl:portType name="ResultByDatePortType"> <wsdl:operation name="resultbydate"> <wsdl:input message="tns:ResultByDateRequest" /> <wsdl:output message="tns:ResultByDateResponse" /> </wsdl:operation> </wsdl:portType> <wsdl:binding name="ResultByDateBinding" type="tns:ResultByDatePortType"> <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="resultbydate"> <soap:operation soapAction="http://www.paysecure.ru/ws/resultbydate" /> <wsdl:input> <soap:body namespace="http://www.paysecure.ru/ws/" use="literal" /> </wsdl:input> <wsdl:output> <soap:body namespace="http://www.paysecure.ru/ws/" use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="ResultByDateService"> <wsdl:port binding="tns:ResultByDateBinding" name="resultbydate"> <soap:address location="" /> </wsdl:port> </wsdl:service> </wsdl:definitions> |