Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Поиск заказа при помощи веб-сервиса производится только за указанный промежуток времени. Для этого нужно задать период, когда была начата оплата заказа, при помощи параметров STARTDAY, STARTMONTH, STARTYEAR, задающих дату начала выборки, и параметров ENDDAY, ENDMONTH, ENDYEAR, задающих дату окончания выборки. Если параметры будут не заданы или заданы неверно, для них будут использованы значения по умолчанию. По умолчанию за дату окончания выборки принимается текущая дата, а за дату начала выборки – текущая дата минус три дня.

...

Название

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

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

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

Описание

Ordernumber

Да

Строка, 128 символов


Номер заказа

Merchant_ID

Да

Число


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

Login

Да

8 - 20 символов


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

Password

Да

8 - 20 символов


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

StartYear

Нет

Год в формате YYYY

Минус 3 дня от текущей даты

Дата начала выборки по Гринвичу (GMT)

StartMonth

Нет

1-12

Минус 3 дня от текущей даты

StartDay

Нет

1-31

Минус 3 дня от текущей даты

StartHour

Нет

0-23

Минус 3 дня от текущей даты

StartMin

Нет

0-59

Минус 3 дня от текущей даты

EndYear

Нет

Год в формате YYYY

Текущий год

Дата окончания выборки по Гринвичу (GMT)

EndMonth

Нет

1-12

Текущий месяц

EndDay

Нет

1-31

Текущий день

EndHour

Нет

0-23

Текущий час

EndMin

Нет

0-59

Текущая минута

Format

Да/Нет

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

4

Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POSTПередается только для запроса в формате POST (по умолчанию ответ будет выдан в формате SOAP). Для других форматов ответ выдается в том же формате, в котором был выполнен запрос.

Multiexcerpt include
MultiExcerptNameValidation
PageWithExcerptБлоки документов

Пример запроса HTTP POST для получения статуса заказа 1001-01, оплата которого началась 1 апреля 2011 2018 года (GMT):

Code Block
languagexml
<FORM ACTION="https://<SERVER-NAME>/orderstate/orderstate.cfm "METHOD="POST">
<INPUT TYPE="HIDDEN" NAME="Ordernumber" VALUE="1001-01">
<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="Startyear" VALUE="2018">
<INPUT TYPE="HIDDEN" NAME="Startmonth" VALUE="04">
<INPUT TYPE="HIDDEN" NAME="Startday" VALUE="01">
<INPUT TYPE="HIDDEN" NAME="Starthour" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Startmin" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Endyear" VALUE="2018">
<INPUT TYPE="HIDDEN" NAME="Endmonth" VALUE="04">
<INPUT TYPE="HIDDEN" NAME="Endday" VALUE="02">
<INPUT TYPE="HIDDEN" NAME="Endhour" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Endmin" VALUE="00">
<INPUT TYPE="HIDDEN" NAME="Format" VALUE="3">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Submit">
</FORM>

...

Название

Значение

billnumber

Уникальный номер заказа в системе АПК Ассист

ordernumber

Номер заказа

orderstate

Статус заказа

orderamount

Оригинальная сумма заказа

ordercurrency

Оригинальны валюта заказа

packetdate

Дата формирования запроса по Гринвичу (GMT)

signature

1) Для типа подписи MD5 - пусто

2) Для типа PGP – значение X, подписанное закрытым ключом АПК Ассист, закодированное в BASE64

checkvalue

1) Для типа подписи PGP - пусто

2) Для типа MD5 – uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х –

строка, сформированная по определенным правилам

результат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency, orderstate (без разделителей), + строковая склейка.

Пример результата ответа в формате CSV:

...

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:orderstateResponse>
<orderstate>
      <order>
        <ordernumber>13032014_121</ordernumber>
        <billnumber>5500069208497981</billnumber>
        <orderamount>121.00</orderamount>
        <ordercurrency>RUB</ordercurrency>
        <orderstate> Declined </orderstate>
        <packetdate>13.03.2018 13:34</packetdate>
        <signature></signature>
        <checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue>
      </order>
      <order>
        <ordernumber>13032014_121</ordernumber>
        <billnumber>5500069208497999</billnumber>
        <orderamount>121.00</orderamount>
        <ordercurrency>RUB</ordercurrency>
        <orderstate>Approved</orderstate>
        <packetdate>13.03.2018 13:34</packetdate>
        <signature></signature>
        <checkvalue>671768C59429DE5A9C5BBD1E7F573666</checkvalue>
      </order>
</orderstate>
</ws:orderstateResponse>
</soapenv:Body></soapenv:Envelope>

...

Warning
titleВнимание!

Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты:

Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости.

...



Наверх