Page History

Versions Compared

Old Version 62

changes.mady.by.user Oksana Chizhikova

Saved on Sept 20, 2022

compared with

New Version Current

changes.mady.by.user Oksana Chizhikova

Saved on Sept 03, 2024

Key

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

...

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

...

Название	Обязательное поле	Принимаемые значения	Значение по умолчанию	Описание
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	Текущая минута
Language	Нет	RU EN	EN	Язык вывода результатов
Format	Да/Нет	3 – - XML 4 - SOAP 5 - JSON4	3	Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POST. Передается только для запроса в формате POST (по умолчанию ответ будет выдан в формате XML). Для других форматов ответ выдается в том же формате, в котором был выполнен запрос.

Multiexcerpt include

MultiExcerptName	Validation
PageWithExcerpt	Блоки документов

...

Название	Значение
*Параметры заказа*
billnumber	Уникальный номер заказа в системе АПК Ассист
ordernumber	Номер заказа
testmode	Тестовый режим
ordercomment	Комментарий
orderamount	Оригинальная сумма заказа
ordercurrency	Оригинальная валюта заказа
firstname	Имя плательщика
lastname	Фамилия плательщика
middlename	Отчество плательщика
Email	Email плательщика
orderdate	Дата заказа по Гринвичу (GMT)
orderstate	Статус заказа
errorcode⁴²	Код ошибки
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 (без разделителей), + строковая склейка
errorcategory³	Категория ответов при неуспешных оплатах, полученная от VISA
merchantadvicecode³	Код уведомления покупателя, полученный от Mastercard
*Параметры операции*
billnumber	Расширенный формат billnumber
operationtype	Тип операции
operationstate	Состояние операции
amount	Сумма операции
currency	Валюта операции
ipaddress	IP-адрес плательщика
clientip	IP-адрес совершившего операцию
meantype_id	Тип платежного средства
meansubtype	Подтип платежного средства
meannumber	Номер платежного средства
cardholder	Держатель платежного средства
cardexpirationdate	Срок действия карты
issuebank	Название банка-эмитента
bankcountry	Страна банка-эмитента
responsecode	Код возврата
message	Сообщение о результате операции
customermessage	Сообщение о результате для покупателя
recommendation	Рекомендация
approvalcode	Код авторизации
protocoltypename	Протокол
processingname	Процессинг
operationdate	Дата и время операции (GMT)
authresult	Результат авторизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U – - неизвестно, R - отказ, C – - не завершено по каким-либо причинам, E - ошибка)
authrequired	Результат проверки вовлеченности карты (1 – - вовлечена, 0 – - не вовлечена, -1 – - неизвестно, null – - ошибка при определении вовлеченности)
slipno	Номер финансовой транзакции, отправляемый в процессинг
errorcode⁴²	Код ошибки
chequeItems¹	Строка с позициями чека в JSON формате согласно разделу «Работа с чеком».
extrrn²³	Уникальный номер платежа в процессинге
externalrefundid³⁴	Внешний идентификатор отмены
*Параметры 3DSecure*
version	Версия протокола 3DSecure
alphaauthresult	Результат авторизации (Y - успешно, N - неуспешно, A - Attempt, U – - невозможно провести аутентификацию, R - отказ, C – - не завершено по каким-либо причинам, E - ошибка), I - для информации, S - без аутентификации с учетом низкой оценки риска)
challenge	Взаимодействие с держателем карты (C – - было, F – - не было, D - отложенная аутентификация)
eci	ElectronicCommerceIndicator (5 – - полная аутентификация, 6 – - попытка аутентификации, 7 – - без аутентификации)

Anchor

	1
	1

...

²Для передачи параметра необходимо обратиться в службу поддержки (support@assist.ru).anchor

Expand

...

³Параметр передается только в том случае, если он был передан в запросе на отмену с помощью сервиса wscancel и формат выдачи результатов запроса JSON или XML.

...

title	Важные особенности использования параметра

Параметр полезен для заказов в статусах Declined и Timeout, он помогает идентифицировать ошибку оплаты (например, построить отчет по разным

...

⁴Для передачи параметра необходимо обратиться в службу поддержки (support@assist.ru).

Expand

title	Подробнее

Параметр полезен для заказов в статусах Declined и Timeout, он помогает идентифицировать ошибку оплаты (например, построить отчет по разным ошибкам), но не определяет статус оплаты. Он будет присутствовать как в блоке данных, относящихся к операции (operation), так и в блоке данных, относящихся к заказу (order). В большинстве случаев для заказа параметр errorcode будет иметь значение 0. Это не означает, что заказ успешно оплачен. Это означает, что нет кода ошибки на уровне заказа. Статус оплаты определяется статусом заказа orderstate и кодом возврата responsecode. Кроме того, может быть создан (и впоследствии закрыт с ошибкой) заказ, не содержащий операции.

Пример результата запроса по заказу без операции:

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:orderresultResponse><orderresult>
   <order>
      <ordernumber>2022_07_12_00_order2</ordernumber>
      <billnumber>516009019085079</billnumber>
      <testmode>0</testmode>
      <ordercomment>test payment</ordercomment>
      <orderamount>120.00</orderamount>
      <ordercurrency>RUB</ordercurrency>
      <firstname/>
      <lastname/>
      <middlename/>
      <email>test@test.ru</email>
      <orderdate>31.08.2022 15:53:38</orderdate>
      <orderstate>Declined</orderstate>
      <errorcode>14</errorcode>
      <packetdate>31.08.2022 15:54</packetdate>
      <signature/>
      <checkvalue>BD01127113BB4E085C2FDCC98175466A</checkvalue>
      </order></orderresult>
</ws:orderresultResponse></soapenv:Body></soapenv:Envelope>

Пример результата запроса по заказу с операцией:

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:orderresultResponse><orderresult>
   <order>
      <ordernumber>FS1662389086973_40</ordernumber>
      <billnumber>5747838257354506</billnumber>
      <testmode>0</testmode>
      <ordercomment>test payment</ordercomment>
      <orderamount>120.00</orderamount>
      <ordercurrency>RUB</ordercurrency>
      <firstname/>
      <lastname/>
      <middlename/>
      <email>test@test.ru</email>
      <orderdate>31.08.2022 15:53:38</orderdate>
      <orderstate>Declined</orderstate>
      <errorcode>0</errorcode>
      <packetdate>31.08.2022 15:54</packetdate>
      <signature/>
      <checkvalue>BD01127113BB4E085C2FDCC98175466A</checkvalue>
      <operation>
         <billnumber>5747838257354506.1</billnumber>
         <operationtype>100</operationtype>
         <operationstate>Failure</operationstate>
         <orderamount>120.00</orderamount>
         <ordercurrency>RUB</ordercurrency>
         <clientip>81.211.118.98</clientip>
         <ipaddress>0.0.0.0</ipaddress>
         <meantype_id>1</meantype_id>
         <meantypename>VISA</meantypename>
         <meansubtype>Visa Platinum Business / Visa Business Enhanced (U.S.)</meansubtype>
         <meannumber>428564****0018</meannumber>
         <cardholder>N/A</cardholder>
         <cardexpirationdate>12/25</cardexpirationdate>
         <issuebank>BANK OTKRITIE</issuebank>
         <bankcountry>Россия</bankcountry>
         <responsecode>AS100</responsecode>
         <message>Отсутствует связь с компонентом аутентификации по 3-D Secure.</message>
         <customermessage>Ошибка аутентификации по 3-D Secure.</customermessage>
         <recommendation>Попытайтесь повторить операцию через некоторое время.</recommendation>
         <approvalcode></approvalcode>
         <protocoltypename>NET</protocoltypename>
         <processingname>XXX</processingname>
         <operationdate>31.08.2022 15:53:38</operationdate>
         <authresult></authresult>
         <authrequired>0</authrequired>
         <slipno></slipno>
         <threedsdata>
            <version>2.2.0</version>
            <alphaauthresult></alphaauthresult>
            <challenge>F</challenge>
            <eci></eci>
         </threedsdata>
         <errorcode>3DS72</errorcode>
      </operation>
   </order></orderresult>
</ws:orderresultResponse></soapenv:Body></soapenv:Envelope>

Anchor

	3
	3

³Для передачи параметра необходимо обратиться в службу поддержки (support@assist.ru).

Anchor

	4
	4

⁴Параметр передается только в том случае, если он был передан в запросе на отмену с помощью сервиса wscancel и формат выдачи результатов запроса JSON или XML.

Warning
Внимание!
Warning
Внимание! В рамках одного заказа может быть проведено несколько операций (оплаты, подтверждения оплаты, отмены). Более того, в рамках одного заказа может быть несколько операций оплаты, если некоторые из них были неуспешными. Успешная операция оплаты заказа может быть только одна. В этих случаях в ответе на запрос о результатах операций по номеру заказа может быть несколько вложенных операций для одного номера заказа.

Warning
Внимание! В полученном ответе необходимо проверить значение параметра testmode. Если платеж был выполнен в тестовом режиме (testmode=1), то отгружать товар или оказывать услугу по текущему заказу не требуется.

Warning
При использовании сервисаимеются ограничения по производительности.

Результат запроса в формате XML будет выглядеть следующим образом:

...

Code Block

language	xml

<?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:orderresultResponse><orderresult>
<order>
      <ordernumber>13032014_122</ordernumber>
      <billnumber>5500069208498005</billnumber>
      <testmode>1</testmode>
      <ordercomment>тестовый платеж</ordercomment>
      <orderamount>122.00</orderamount>
      <ordercurrency>RUB</ordercurrency>
      <firstname>Test</firstname>
      <lastname>Testov</lastname>
      <middlename>T.</middlename>
      <email>test@test.ru</email>
      <orderdate>13.03.2018 13:38:24</orderdate>
      <orderstate>Timeout</orderstate>
      <packetdate>13.03.2018 14:55</packetdate>
      <signature></signature>
      <checkvalue>863F176DC699131758B2230EA93BC911</checkvalue>
</order>
<order>
      <ordernumber>13032014_122</ordernumber>
      <billnumber>5500069208498070</billnumber>
      <testmode>1</testmode>
      <ordercomment>тестовый платеж</ordercomment>
      <orderamount>122.00</orderamount>
      <ordercurrency>RUB</ordercurrency>
      <firstname>Test</firstname>
      <lastname>Testov</lastname>
      <middlename>T.</middlename>
      <email>test@test.ru</email>
      <orderdate>13.03.2018 14:52:09</orderdate>
      <orderstate>Approved</orderstate>
      <packetdate>13.03.2018 14:55</packetdate>
      <signature></signature>
      <checkvalue>E458CD73F1AA3F994F4D97C40613FD0A</checkvalue>
      <operation>
         <billnumber>5500069208498070.1</billnumber>
         <operationtype>100</operationtype>
         <operationstate>Success</operationstate>
         <amount>122.00</amount>
         <currency>RUB</currency>
         <clientip>10.10.10.10</clientip>
         <ipaddress>0.0.0.0</ipaddress>
         <meantype_id>1</meantype_id>
         <meantypename>VISA</meantypename>
         <meansubtype>Busines</meansubtype>
         <meannumber>462710****4724</meannumber>
         <cardholder>TEST</cardholder>
         <cardexpirationdate>12/20</cardexpirationdate>
         <issuebank>Bank</issuebank>
         <bankcountry>RUS</bankcountry>
         <responsecode>AS000</responsecode>
         <message></message>
         <customermessage></customermessage>
         <recommendation></recommendation>
         <approvalcode>X53576</approvalcode>
         <protocoltypename>NET</protocoltypename>
         <processingname>Fake</processingname>
         <operationdate>13.03.2018 14:52:10</operationdate>
         <authresult></authresult>
         <authrequired>0</authrequired>
         <slipno>111111</slipno>
         <threedsdata>
             <version>1.0.0</version>
             <alphaauthresult>C</alphaauthresult>
             <challenge>C</challenge>
             <eci></eci>
         </threedsdata>
      </operation>
      <operation>
         <billnumber>5500069208498070.2</billnumber>
         <operationtype>200</operationtype>
         <operationstate>Success</operationstate>
         <amount>122.00</amount>
         <currency>RUB</currency>
         <clientip>10.10.10.10</clientip>
         <ipaddress>0.0.0.0</ipaddress>
         <meantype_id>1</meantype_id>
         <meantypename>VISA</meantypename>
         <meansubtype>Busines</meansubtype>
         <meannumber>462710****4724</meannumber>
         <cardholder>TEST</cardholder>
         <cardexpirationdate>12/20</cardexpirationdate>
         <issuebank>Bank</issuebank>
         <bankcountry>RUS</bankcountry>
         <responsecode>AS000</responsecode>
         <message></message>
         <customermessage></customermessage>
         <recommendation></recommendation>
         <approvalcode></approvalcode>
         <protocoltypename></protocoltypename>
         <processingname>Fake</processingname>
         <operationdate>13.03.2018 14:53:37</operationdate>
         <authresult></authresult>
         <authrequired>0</authrequired>
         <slipno>111111</slipno>
         <threedsdata>
             <version>1.0.0</version>
             <alphaauthresult>Y</alphaauthresult>
             <challenge>C</challenge>
             <eci>5</eci>
         </threedsdata>
      </operation>
</order>
</orderresult></ws:orderresultResponse></soapenv:Body></soapenv:Envelope>

...

  </operation>
</order>
</orderresult></ws:orderresultResponse></soapenv:Body></soapenv:Envelope>

Warning

title	Внимание!

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

корневые сертификаты от GlobalSign (https://www.globalsign.com/repository/ca-certificates/):
- GlobalSign Root R3;
- GlobalSign ECC Root R5;
- GlobalSign Root R6.

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

...

Наверх

Content

Space Tools

Versions Compared

Old Version 62

New Version Current

Key