Page History
...
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
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 | 3 | Формат выдачи результатов. Не нужно передавать в случае формата SOAP, нужно для формата POST. Передается только для запроса в формате POST (по умолчанию ответ будет выдан в формате XML). Для других форматов ответ выдается в том же формате, в котором был выполнен запрос. |
| Note |
|---|
Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл. "Правила валидации входных параметров". |
...
Название | Значение | ||
Параметры заказа | |||
billnumber | Уникальный номер заказа в системе АПК Ассист | ||
ordernumber | Номер заказа | ||
testmode | Тестовый режим | ||
ordercomment | Комментарий | ||
orderamount | Оригинальная сумма заказа | ||
ordercurrency | Оригинальная валюта заказа | ||
firstname | Имя плательщика | ||
lastname | Фамилия плательщика | ||
middlename | Отчество плательщика | ||
Email плательщика | |||
orderdate | Дата заказа по Гринвичу (GMT) | ||
orderstate | Статус заказа | ||
errorcode2 | |||
packetdate | Дата формирования запроса по Гринвичу (GMT) | ||
signature | 1) Для типа подписи MD5 - пусто 2) Для типа PGP – значение X, подписанное закрытым ключом АПК Ассист, закодированное в BASE64 | ||
checkvalue | 1) Для типа подписи PGP - пусто 2) Для типа MD5 – uppercase(md5(uppercase(md5(SALT) + md5(Х)))), | checkvalue | uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правиламрезультат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency, orderstate (без разделителей), + строковая склейка |
Параметры операции | |||
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 | Номер финансовой транзакции, отправляемый в процессинг (не используется) | ||
errorcode2 | |||
externalrefundid1 | Внешний идентификатор отмены | ||
Параметры 3DSecure | |||
version | Версия протокола 3DSecure | ||
alphaauthresult | Результат авторизации (Y - успешно, N - неуспешно, A - Attempt, U – невозможно провести аутентификацию, R- отказ, C – не завершено по каким-либо причинам, E - ошибка), I - для информации) | ||
challenge | Взаимодействие с держателем карты (C – было, F – не было, D - отложенная аутентификация) | ||
eci | Electronic Commerce Indicator (5 – полная аутентификация, 6 – попытка аутентификации, 7 – без аутентификации) | ||
...
| Warning |
|---|
При использовании сервиса имеются ограничения по производительности. |
Результат запроса в формате XML будет выглядеть следующим образом:
...
| Code Block | ||
|---|---|---|
| ||
<?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>100.00</orderamount>
<ordercurrency>BYN</ordercurrency>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.by</email>
<orderdate>06.07.2016 13:38:24</orderdate>
<orderstate>Timeout</orderstate>
<packetdate>06.07.2016 14:55</packetdate>
<signature></signature>
<checkvalue>863F176DC699131758B2230EA93BC911</checkvalue>
</order>
<order>
<ordernumber>13032014_122</ordernumber>
<billnumber>5500069208498070</billnumber>
<testmode>1</testmode>
<ordercomment>тестовый платеж</ordercomment>
<orderamount>100.00</orderamount>
<ordercurrency>BYN</ordercurrency>
<firstname>Test</firstname>
<lastname>Testov</lastname>
<middlename>T.</middlename>
<email>test@test.by</email>
<orderdate>06.07.2016 14:52:09</orderdate>
<orderstate>Approved</orderstate>
<packetdate>06.07.2016 14:55</packetdate>
<signature></signature>
<checkvalue>E458CD73F1AA3F994F4D97C40613FD0A</checkvalue>
<operation>
<billnumber>5500069208498070.1</billnumber>
<operationtype>100</operationtype>
<operationstate>Success</operationstate>
<amount>100.00</amount>
<currency>BYN</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>06.07.2016 14:52:10</operationdate>
<authresult></authresult>
<authrequired>0</authrequired>
<slipno></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>100.00</amount>
<currency>BYN</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>06.07.2016 14:53:37</operationdate>
<authresult></authresult>
<authrequired>0</authrequired>
<slipno></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> |
| Warning | ||
|---|---|---|
| ||
| Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты: корневой сертификат от Comodo: COMODO RSA Certification Authority
Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости. |