Page History
...
Список параметров ответа:
Название | Значение |
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:
| Panel |
|---|
ordernumber;billnumber;orderamount;ordercurrency;orderstate;packetdate;signature;checkvalue;2306-08;551508910014022;100.00;KZT;Approved;23.06.2011 11:59;; D6313123A5C09; |
В формате XML:
| Code Block | ||
|---|---|---|
| ||
<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<!DOCTYPE result [
<!ATTLIST result
firstcode CDATA #REQUIRED
secondcode CDATA #REQUIRED
count CDATA #REQUIRED>
<!ELEMENT result (order*)>
<!ELEMENT order (ordernumber?,billnumber?,orderamount?,ordercurrency?,orderstate?,packetdate?,checkvalue?)>
<!ELEMENT ordernumber (#PCDATA)>
<!ELEMENT billnumber (#PCDATA)>
<!ELEMENT orderamount (#PCDATA)>
<!ELEMENT ordercurrency (#PCDATA)>
<!ELEMENT orderstate (#PCDATA)>
<!ELEMENT packetdate (#PCDATA)>
<!ELEMENT checkvalue (#PCDATA)>]>
<result firstcode='0' secondcode='0' count='1'>
<order><ordernumber>0001-01</ordernumber>
<billnumber>511111100000001</billnumber>
<orderamount>100.00</orderamount>
<ordercurrency>KZT</ordercurrency>
<orderstate>Approved</orderstate>
<packetdate>01.01.2018 11:58</packetdate>
<signature></signature>
<checkvalue>
</checkvalue>
</order></result> |
Пример результата запроса в формате XML, вернувшего ошибку (неправильный пароль):
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<!DOCTYPE result [...]>
<result firstcode="7"
secondcode="102" count="0"></result> |
С описанием первого и второго кодов ошибок можно ознакомиться в таблице Коды ошибок.
Описание веб-сервиса для формата SOAP можно увидеть на странице:
https://<SERVER-NAME>/orderstate/orderstate.wsdl
Если попытка оплаты заказа была неуспешной (не прошла авторизация платежного средства или превышено время ожидания), то при повторной попытке оплаты будет создан новый уникальный номер (billnumber) в АПК Ассист для того же номера заказа в интернет-магазине, что будет отражено в ответе на запрос о статусе заказа.
Пример ответа в формате SOAP для случая успешной оплаты заказа со второй попытки:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://www.paysecure.kz/ws/"><soapenv:Body>
<ws:orderstateResponse>
<orderstate>
<order>
<ordernumber>13032014_121</ordernumber>
<billnumber>5500069208497981</billnumber>
<orderamount>121.00</orderamount>
<ordercurrency>KZT</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>KZT</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 | ||
|---|---|---|
| ||
Для корректной работы с веб-сервисами по защищенному TLS-соединению необходимо иметь на своей стороне в хранилище доверенных корневых сертификатов следующие сертификаты:
Перед началом работы следует проверить наличие этих сертификатов в хранилище и добавить их в случае необходимости. |